Partager via


CPosPassThru::CheckCapabilities (Windows Embedded CE 6.0)

1/6/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

Windows Embedded CE Windows CE 2.12 and later
Note Microsoft 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

See Also

Reference

CPosPassThru Class