IMFMediaEngineEx::UpdateVideoStream method

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


HRESULT UpdateVideoStream(
  [inconst MFVideoNormalizedRect *pSrc,
  [inconst RECT                  *pDst,
  [inconst MFARGB                *pBorderClr


pSrc [in]

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.

pDst [in]

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.

pBorderClr [in]

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.


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.


Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]



See also




© 2016 Microsoft