 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
- Pointer to an AM_SEEKING_SEEKING_CAPABILITIES enumerator
containing the seeking capabilities flags to apply. These flags can
be any combination of the following:
- AM_SEEKING_CanGetCurrentPos
- AM_SEEKING_CanGetDuration
- AM_SEEKING_CanGetStopPos
- AM_SEEKING_CanPlayBackwards
- AM_SEEKING_CanSeekAbsolute
- AM_SEEKING_CanSeekBackwards
- AM_SEEKING_CanSeekForwards
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 member function implements IMediaSeeking::CheckCapabilities, by calling the IMediaSeeking::CheckCapabilitiesmethod on the upstream output pin connected to the peer input pin. The pin that performs the seek operation will return whether the flags presented in the pCapabilitiesparameter are present. This returned value will then, in turn, propagate to calls made from CPosPassThru::CheckCapabilitiesmember functions in intervening filters.