IMSVidPlayback::get_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 get_PositionMode method indicates how position values are interpreted by this interface.

Syntax

HRESULT get_PositionMode(
  [out] PositionModeList *lPositionMode
);

Parameters

[out] lPositionMode

Pointer to a variable that receives 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
E_FAIL	Failure.
E_POINTER	NULL pointer argument.
ERROR_INVALID_STATE	The graph is not built. Call the Build or View method on the Video Control.
S_OK	The method succeeded.

�

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

�

Remarks

The value returned by this method 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.

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