 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
Determines which capabilities exist on a media stream by applying seeking capability flags and checking the returned value.
HRESULT CheckCapabilities( DWORD * pCapabilities );
Parameters
- pCapabilities
- [in, out] Pointer to an
AM_SEEKING_SEEKING_CAPABILITIESenum type containing the
seeking capabilities flags to apply. These flags can be any
combination of the following:
- AM_SEEKING_CanSeekAbsolute
- AM_SEEKING_CanSeekForwards
- AM_SEEKING_CanSeekBackwards
- AM_SEEKING_CanGetCurrentPos
- AM_SEEKING_CanGetStopPos
- AM_SEEKING_CanGetDuration
- AM_SEEKING_CanPlayBackwards
- AM_SEEKING_CanDoSegments
- AM_SEEKING_Source
Return Values
Returns S_OK if all capabilities in pCapabilitiesare present, S_FALSE if some are present, or E_FAIL if none are present.
Remarks
This method determines which seeking capabilities are present on a media stream. It applies the pCapabilitiesflags using a bitwise-AND operation, and returns a value to indicate whether they match the capabilities of the media stream. The value of pCapabilitiesis accumulated between successive calls to this method so that the value of pCapabilitiescan be checked when an S_FALSE value is returned to find the capability that does not match.