Edit

Share via

IMFMediaEngineEx::UpdateVideoStream method (mfmediaengine.h)

  • Article

Updates the source rectangle, destination rectangle, and border color for the video.

Syntax

HRESULT UpdateVideoStream(
  [in] const MFVideoNormalizedRect *pSrc,
  [in] const RECT                  *pDst,
  [in] const MFARGB                *pBorderClr
);

Parameters

[in] pSrc

A pointer to an MFVideoNormalizedRect structure that specifies the source rectangle. The source rectangle defines the area of the video frame that is displayed. If this parameter is NULL, the entire video frame is displayed.

[in] pDst

A pointer to a RECT structure that specifies the destination rectangle. The destination rectangle defines the area of the window or DirectComposition visual where the video is drawn.

[in] pBorderClr

A pointer to an MFARGB structure that specifies the border color.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

In rendering mode, call this method to reposition the video, update the border color, or repaint the video frame. If all of the parameters are NULL, the method repaints the most recent video frame.

In frame-server mode, this method has no effect.

See Video Processor MFT for info regarding source and destination rectangles in the Video Processor MFT.

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

IMFMediaEngineEx