IMSVidPlayback::put_PositionMode 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_PositionMode method specifies how position values will be interpreted by this interface.

Syntax

HRESULT put_PositionMode(
  [in] PositionModeList lPositionMode
);

Parameters

[in] lPositionMode

Specifies one of the following values.

Value	Description
FrameMode	Position values are specified as frame numbers.
TenthsSecondsMode	Position values are specified as hundredths of seconds.

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_FAIL	Failed. Possibly the source does not support this mode.
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

The position mode determines how the parameters are interpreted for the following methods:

• IMSVidPlayback::get_Length
• IMSVidPlayback::get_CurrentPosition
• IMSVidPlayback::put_CurrentPosition

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

Examples

hr = m_pPlayback->put_PositionMode(TenthsSecondsMode);

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

get_PositionMode