MFCopyImage 函数 (mfapi.h)

将图像或图像平面从一个缓冲区复制到另一个缓冲区。

语法

HRESULT MFCopyImage(
  [in] BYTE       *pDest,
  [in] LONG       lDestStride,
  [in] const BYTE *pSrc,
  [in] LONG       lSrcStride,
  [in] DWORD      dwWidthInBytes,
  [in] DWORD      dwLines
);

参数

[in] pDest

指向目标缓冲区中第一行像素开头的指针。

[in] lDestStride

目标缓冲区的步幅(以字节为单位)。

[in] pSrc

指向源图像中第一行像素开头的指针。

[in] lSrcStride

源图像的步幅(以字节为单位)。

[in] dwWidthInBytes

图像的宽度(以字节为单位)。

[in] dwLines

要复制的像素行数。

返回值

如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此函数复制图像的单个平面。 对于平面 YUV 格式,必须为每个平面调用一次 函数。 在这种情况下, pDestpSrc 必须指向每个平面的起点。

如果 MMX、SSE 或 SSE2 指令集在处理器上可用,则会优化此函数。 函数执行非时态存储, (数据直接写入内存,而不会污染缓存) 。

注意 在 Windows 7 之前,此函数是从 evr.dll 导出的。 从 Windows 7 开始,此函数从 mfplat.dll 导出,evr.dll 导出调用 mfplat.dll 的存根函数。 有关详细信息,请参阅 Windows 7 中的库更改
 

要求

要求
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 mfapi.h
Library Evr.lib
DLL Mfplat.dll

另请参阅

图像步幅

媒体基础函数

媒体类型