IltmmPlay::CheckSeekingCapabilities

#include "ltmm.h"

C Syntax

HRESULT IltmmPlay_CheckSeekingCapabilities(pPlay, Mask, pCaps)

C++ Syntax

HRESULT CheckSeekingCapabilities(Mask, pCaps)

 

IltmmPlay *pPlay;

/* pointer to an interface */

long *Mask;

/* pointer to a variable */

long *pCaps;

/* pointer to a variable */

Queries whether the object is capable of performing a specified seeking operation.

Parameter

Description

pPlay

Pointer to an IltmmPlay interface.

Mask

Pointer to a bitwise combination of one or more ltmmPlay_Seek attributes. When the function returns, the value indicates which of those attributes are available.

pCaps

Pointer to a variable that receives the queried capabilities.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

Declare a long value equal to the bitwise-OR combination of the ltmmPlay_Seek attributes that you want to test. Pass this value in the Mask parameter. When the function returns, pCaps contains a subset of the original bits, indicating which capabilities are present. The return value indicates whether some, none, or all of the requested capabilities are present.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64, Mobile

See Also

Elements:

IltmmPlay::put_CurrentPosition, IltmmPlay::put_CurrentFramePosition, IltmmPlay::put_CurrentTrackingPosition, ltmmPlay_Seeking Constants

Topics:

Multimedia Function Group

Example

For a C example, refer to the Simple Media Player for C.

For a C++ example, refer to the Simple Media Player for C++.