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 格式，必须为每个平面调用一次 函数。 在这种情况下， pDest 和 pSrc 必须指向每个平面的起点。

如果 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

另请参阅

图像步幅

媒体基础函数

媒体类型