CPosPassThru::CheckCapabilities

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

Syntax

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 Value

Returns S_OK if all capabilities in pCapabilities are 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::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.

Requirements