IEnumMediaTypes::Skip
| Microsoft DirectShow 9.0 |
IEnumMediaTypes::Skip
The Skip method skips over a specified number of media types.
Syntax
HRESULT Skip( ULONG cMediaTypes );
Parameters
cMediaTypes
[in] Number of media types to skip.
Return Values
Returns one of the following HRESULT values.
| Value | Description |
| S_FALSE | Skipped past the end of the sequence. |
| S_OK | Success. |
| VFW_E_ENUM_OUT_OF_SYNC | The pin's state has changed and is now inconsistent with the enumerator. |
Remarks
If the set of media types changes, the enumerator is no longer consistent with the pin, and the method returns VFW_E_ENUM_OUT_OF_SYNC. Discard any data obtained from previous calls to the enumerator, because it might be invalid. Update the enumerator by calling the IEnumMediaTypes::Reset method. You can then call the Skip method safely.
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also