IMDSPEnumDevice::Skip

The Skip method skips over the next specified number of Media Device interface(s) in the enumeration sequence.

Syntax

HRESULT Skip(
  ULONG  celt,
  ULONG*  pceltFetched
);

Parameters

celt

[in] Number of elements to skip.

pceltFetched

[out] Pointer to the number of elements that actually were skipped.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code	Description
S_FALSE	Did not skip the number of elements requested.
E_FAIL	An unspecified error occurred.

Remarks

If the number to skip specified in the celt parameter is greater than the actual number of Media Device interfaces remaining in the enumeration sequence, then the return value from Skip is S_FALSE. When this happens, the pceltFetched parameter must be queried to determine how many interfaces were skipped. If you skip to the end of the array of Windows Media Device Manager interfaces, a subsequent call to Next returns S_FALSE.

See Also

IMDSPEnumDevice Interface

Previous

Next