IAMVideoCutListElement provides support for a cutlist element from an AVI video file stream.
See About Cutlists and Using Cutlists for more information.
When to Implement
Usually, you don't need to implement this interface because DirectShow provides the CLSID_VideoFileClip object that implements it for you. Implement this interface in your application when 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 the IAMCutListElement interface to determine if the element is a video type element.
When compiling a cutlist application you must explicitly include the cutlist header file as follows:
#include <cutlist.h>
Methods in Vtable Order
| IUnknown methods | Description |
| QueryInterface | Retrieves pointers to supported interfaces. |
| AddRef | Increments the reference count. |
| Release | Decrements the reference count. |
| IAMVideoCutListElement methods | Description |
| IsSingleFrame | Determines if the element is a single frame with repeating fields. |
| GetStreamIndex | Retrieves the index to the specified stream in the AVI file. |
Retrieves 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. The only supported video stream in an AVI file is the first video stream.
Determines if the element is a single frame with repeating fields.
HRESULT IsSingleFrame(void);
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 because repeating fields are not supported.
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.