IMSVidPlayback::Step method (segment.h)

Article
12/05/2018

[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 Step method steps through the video stream by a specified number of frames.

Syntax

HRESULT Step(
  [in] long lStep
);

Parameters

[in] lStep

Specifies how many frames to step. If lStep is 1, the Video Control steps forward one frame. If lStep is a number N greater than 1, the Video Control skips N - 1 frames and shows the Nth frame.

Return value

The method returns an HRESULT. Possible values include the following.

Return code	Description
E_NOTIMPL	Not implemented.
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

Although a negative value for lStep is defined as stepping backward, that functionality is currently not implemented, and the method returns E_NOTIMPL.

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