IEnumPins::Skip
| Microsoft DirectShow 9.0 |
IEnumPins::Skip
The Skip method skips over a specified number of pins.
Syntax
HRESULT Skip( ULONG cPins );
Parameters
cPins
[in] Number of pins to skip.
Return Values
Returns one of the following HRESULT
| Value | Description |
| S_FALSE | Skipped past the end of the sequence. |
| S_OK | Success. |
| VFW_E_ENUM_OUT_OF_SYNC | The filter's state has changed and is now inconsistent with the enumerator. |
Remarks
If the number of pins changes, the enumerator is no longer consistent with the filter, 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 IEnumPins::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