Share via


IMSVidPlayback::get_Length 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_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)

See also

IMSVidPlayback Interface