IAMVideoCutListElement Interface

IAMVideoCutListElement provides support for a cutlist element from an AVI video file stream.

See About Cutlists and Using Cutlists for more information.

Usually, you don't need to implement this interface because Microsoft® 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.

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.

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.

IAMVideoCutListElement::GetStreamIndex

IAMVideoCutListElement Interface

Retrieves the index to the specified stream in the AVI file.

Syntax

HRESULT GetStreamIndex(
  DWORD *piStream
  );

Parameters

piStream
[out] Pointer to the stream number to open.

Return Value

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.

E_FAIL Failure.
E_INVALIDARG Argument is invalid.
E_NOTIMPL Method is not supported.
E_POINTER Null pointer argument.
S_OK Success.

Remarks

The stream number must always be zero. The only supported video stream in an AVI file is the first video stream.

IAMVideoCutListElement::IsSingleFrame

IAMVideoCutListElement Interface

Determines if the element is a single frame with repeating fields.

Syntax

HRESULT IsSingleFrame(void);

Return Value

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.

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.

Remarks

This method must always return S_FALSE because repeating fields are not supported.

E_FAIL	Failure.
E_INVALIDARG	Argument is invalid.
E_NOTIMPL	Method is not supported.
E_POINTER	Null pointer argument.
S_OK	Success.