IMSVidPlayback::put_CurrentPosition

  • Article
 
Microsoft DirectShow 9.0

IMSVidPlayback::put_CurrentPosition

This topic applies to Windows XP or later.

The put_CurrentPosition method seeks to a specified position in the source.

Syntax

  HRESULT put_CurrentPosition(
  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 Values

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

Value 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: Dshow.h.

  Library: Quartz.dll.

See Also