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

另请参阅

IMFMediaEngine