IMSVidPlayback::get_Length method (segment.h)

2018-12-05

[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_Length method retrieves the length of the playback source.

Syntax

HRESULT get_Length(
  [out] long *lLength
);

Parameters

[out] lLength

Pointer to a variable that receives the length. The units for the returned value 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
E_NOINTERFACE	The source does not support getting the length.
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

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)

Share via