IMFMediaEngine：：TransferVideoFrame 方法 (mfmediaengine.h)

將目前的視訊框架複製到 DXGI 表面或 WIC 點陣圖。

語法

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

參數

[in] pDstSurf

目的地介面 之 IUnknown 介面的指標。

[in] pSrc

指定來源矩形 之 MFVideoNormalizedRect 結構的指標。

[in] pDst

指定目的地矩形之 RECT 結構的指標。

[in] pBorderClr

指定框線色彩之 MFARGB 結構的指標。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

在畫面伺服器模式中，呼叫這個方法以將視訊畫面點選到 DXGI 或 WIC 表面。 應用程式可以在媒體引擎載入視訊資源之後隨時呼叫這個方法。 不過，應用程式通常會先呼叫 IMFMediaEngine：：OnVideoStreamTick ，以判斷是否有新的畫面可用。 如果 OnVideoStreamTick 傳回 S_OK，應用程式接著會呼叫 TransferVideoFrame。

媒體引擎會縮放和寄信箱視訊，以符合目的矩形。 它會以框線色彩填滿信件箱區域。

針對受保護的內容，請呼叫 IMFMediaEngineProtectedContent：：TransferVideoFrame 方法，而不是這個方法。

需求

最低支援的用戶端	Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	mfmediaengine.h

另請參閱

IMFMediaEngine