IMSVidPlayback::Step

 
Microsoft DirectShow 9.0

IMSVidPlayback::Step

This topic applies to Windows XP or later.

The Step method steps through the video stream by a specified number of frames.

Syntax

  HRESULT Step(
  long  lStep
);

Parameters

lStep

[in]  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 Values

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

Value 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

  Header: Dshow.h.

  Library: Quartz.dll.

See Also