GetMetaFileBitsEx 函数 (wingdi.h)
GetMetaFileBitsEx 函数检索 Windows 格式图元文件的内容,并将其复制到指定的缓冲区中。
注意 提供此函数仅用于与 Windows 格式图元文件的兼容性。 增强格式的图元文件提供卓越的功能,建议用于新应用程序。 增强格式图元文件的相应函数为 GetEnhMetaFileBits。
语法
UINT GetMetaFileBitsEx(
[in] HMETAFILE hMF,
[in] UINT cbBuffer,
[out] LPVOID lpData
);
参数
[in] hMF
Windows 格式图元文件的句柄。
[in] cbBuffer
要接收数据的缓冲区的大小(以字节为单位)。
[out] lpData
指向接收图元文件数据的缓冲区的指针。 缓冲区必须足够大才能包含数据。 如果 lpvData 为 NULL,则该函数返回保存数据所需的字节数。
返回值
如果函数成功且缓冲区指针为 NULL,则返回值是缓冲区所需的字节数;如果函数成功,并且缓冲区指针是有效的指针,则返回值是复制的字节数。
如果函数失败,则返回值为零。
注解
检索 Windows 图元文件位后,可以通过调用 SetMetaFileBitsEx 函数使用这些位来创建基于内存的图元文件。
GetMetaFileBitsEx 函数不会使图元文件句柄失效。 应用程序必须通过调用 DeleteMetaFile 函数删除此句柄。
若要将 Windows 格式的图元文件转换为增强格式的图元文件,请使用 SetWinMetaFileBits 函数。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | wingdi.h (包括 Windows.h) |
Library | Gdi32.lib |
DLL | Gdi32.dll |