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