IMFMediaEngine::OnVideoStreamTick method (mfmediaengine.h)

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


HRESULT OnVideoStreamTick(
  [out] LONGLONG *pPts


[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
The method succeeded, but the Media Engine does not have a new frame.
A new video frame is ready for display.


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.


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