IMFMediaEngine::TransferVideoFrame 方法 (mfmediaengine.h)
将当前视频帧复制到 DXGI 图面或 WIC 位图。
语法
HRESULT TransferVideoFrame(
[in] IUnknown *pDstSurf,
[in] const MFVideoNormalizedRect *pSrc,
[in] const RECT *pDst,
[in] const MFARGB *pBorderClr
);
parameters
[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 |