Microsoft DirectX 9.0

IMSVidPlayback::put_CurrentPosition

This topic applies to Windows XP only.

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.

See Also