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