The IAMAudioCutListElement interface provides support for a cutlist element for an audio file stream in a WAV or AVI file.
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_AudioFileClip object that implements it for you. Implement this interface in your application when you need to change the default behavior of this interface.
When to Use
Use this interface in your filter when you specify an audio-based media clip. Call QueryInterface on the IAMCutListElement interface to determine if the element is an audio 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. |
| IAMAudioCutListElement methods | Description |
| GetStreamIndex | Retrieves the index to the stream in the AVI file. |
| HasFadeIn | Determines if the element fades in automatically. |
| HasFadeOut | Determines if the element fades out automatically. |
Retrieves the index to the 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. |
This method must always retrieve zero for the stream index. For AVI files, only the first audio stream is supported.
Determines if the element fades in automatically.
HRESULT HasFadeIn(void);
Returns S_OK if the element should be automatically faded in, or S_FALSE if not.
This method always returns S_OK, but fading in and out is not currently supported.
Determines if the element fades out automatically.
HRESULT HasFadeOut(void);
Returns S_OK if the element should be automatically faded out, or S_FALSE if not.
This method always returns S_OK, but fading in and out is not currently supported.
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.