IVideoCutListElement supports a cutlist element for a video (.AVI) file stream.
See IStandardCutList for information about other cutlist interfaces.
When to Implement
Normally you don't need to implement this interface because DirectShow provides the CLSID_VideoFileClip object which implements it for you. Implement this interface in your application if you need to change the default behavior of this interface to include support for interlaced video.
When to Use
Use this interface in your filter when you specify a video-based media clip. Call QueryInterface on ICutListElement to determine if the element is a video type element.
Methods in Vtable Order
| IUnknown methods | Description |
| QueryInterface | Retrieves pointers to supported interfaces. |
| AddRef | Increments the reference count. |
| Release | Decrements the reference count. |
| IVideoCutListElement methods | Description |
| IsSingleFrame | Determines if the element is a single frame with repeating fields. |
| GetStreamIndex | Returns the index to the specified stream in the AVI file. |
Determines if the element is a single frame with repeating fields.
HRESULT IsSingleFrame(void);
Returns S_TRUE ?????? or S_OK ?????? if this element is to be played with the source being a single frame, with fields repeating normally. Returns S_FALSE if the fields are interpolated.
Returns an HRESULT value that depends on the implementation of the interface. HRESULT can include one of the following standard constants, or other values not listed.
| Value | Meaning |
| E_FAIL | Failure. |
| E_INVALIDARG | Argument is invalid. |
| E_NOTIMPL | Method is not supported. |
| E_POINTER | Null pointer argument. |
| S_FALSE | No, element is not a single frame with repeating fields. |
| S_OK | Yes, element is a single frame with repeating fields. |
This method must always return S_FALSE as repeating fields are not supported.
Returns the index to the specified stream in the AVI file.
HRESULT GetStreamIndex(
DWORD *piStream
);
Returns an HRESULT value that depends on the implementation of the interface. HRESULT can include one of the following standard constants, or other values not listed.
| Value | Meaning |
| E_FAIL | Failure. |
| E_INVALIDARG | Argument is invalid. |
| E_NOTIMPL | Method is not supported. |
| E_POINTER | Null pointer argument. |
| S_OK | Success. |
The stream number must always be zero (0). The only supported video stream in an AVI file is the first video stream.
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.