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 |