Share via

IMSVidPlayback::put_CurrentPosition Method

  • Article

This topic applies to Windows XP or later.
The put_CurrentPosition method seeks to a specified position in the source.

Syntax

HRESULT put_CurrentPosition(
  [in]  long lPosition
);

Parameters

  • lPosition [in]
    Specifies the new position. The units for this parameter are determined by the current position mode.

    Position Mode Returned Value
    FrameMode Frame number
    TenthsSecondsMode Hundredths of seconds

    To set the position mode, call IMSVidPlayback::put_PositionMode.

Return Value

The method returns an HRESULT. Possible values include the following.

Return code Description

ERROR_INVALID_STATE

The graph is not built. Call the Build or View method on the Video Control.

E_INVALIDARG

Invalid argument.

S_OK

The method succeeded.

Note  The value ERROR_INVALID_STATE is converted to an HRESULT with the HRESULT_FROM_WIN32 macro.

Remarks

If the new position is earlier than the current position and the source cannot seek backward, the method returns E_INVALIDARG.

Call the IMSVidCtl::Build or IMSVidCtl::View method before calling this method.

Requirements

Header Declared in Dshow.h.
DLL Requires Quartz.dll.

See Also

IMSVidPlayback Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008