IMFMediaEngine::OnVideoStreamTick method (mfmediaengine.h)

Queries the Media Engine to find out whether a new video frame is ready.

Syntax

HRESULT OnVideoStreamTick(
  [out] LONGLONG *pPts
);

Parameters

[out] pPts

If a new frame is ready, receives the presentation time of the frame.

Return value

This method can return one of these values.

Return code Description
S_FALSE
The method succeeded, but the Media Engine does not have a new frame.
S_OK
A new video frame is ready for display.

Remarks

In frame-server mode, the application should call this method whenever a vertical blank occurs in the display device. If the method returns S_OK, call IMFMediaEngine::TransferVideoFrame to blit the frame to the render target. If the method returns S_FALSE, wait for the next vertical blank and call the method again.

Do not call this method in rendering mode or audio-only mode.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 [desktop apps | UWP apps]
Target Platform Windows
Header mfmediaengine.h

See also

IMFMediaEngine