CPosPassThru::CheckCapabilities

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

Determines which capabilities exist on a media stream by applying seeking capability flags and checking the returned value.


HRESULT CheckCapabilities(
  DWORD* pCapabilities 
);

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

Returns S_OK if all capabilities in pCapabilities are present, S_FALSE if some are present, or E_FAIL if none are present.

This member function implements IMediaSeeking::CheckCapabilities, by calling the IMediaSeeking::CheckCapabilities method 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 pCapabilities parameter are present.

This returned value will then, in turn, propagate to calls made from CPosPassThru::CheckCapabilities member functions in intervening filters.

Windows Embedded CEWindows CE 2.12 and later
Windows MobileWindows Mobile Version 5.0 and later
NoteMicrosoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later

Community Additions

Show: