IMSVidPlayback::put_CurrentPosition method (segment.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

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

Syntax

HRESULT put_CurrentPosition(
  [in] long lPosition
);

Parameters

[in] lPosition

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

Requirement Value
Minimum supported client Windows�XP [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header segment.h (include Msvidctl.h)

See also

IMSVidPlayback Interface