CPosPassThru::CheckCapabilities

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 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

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.
Header:

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.