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 |