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

指向接收图元文件数据的缓冲区的指针。 缓冲区必须足够大才能包含数据。 如果 lpvDataNULL,则该函数返回保存数据所需的字节数。

返回值

如果函数成功且缓冲区指针为 NULL,则返回值是缓冲区所需的字节数;如果函数成功,并且缓冲区指针是有效的指针,则返回值是复制的字节数。

如果函数失败,则返回值为零。

注解

检索 Windows 图元文件位后,可以通过调用 SetMetaFileBitsEx 函数使用这些位来创建基于内存的图元文件。

GetMetaFileBitsEx 函数不会使图元文件句柄失效。 应用程序必须通过调用 DeleteMetaFile 函数删除此句柄。

若要将 Windows 格式的图元文件转换为增强格式的图元文件,请使用 SetWinMetaFileBits 函数。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

DeleteMetaFile

GetEnhMetaFileBits

图元文件函数

图元文件概述

SetMetaFileBitsEx

SetWinMetaFileBits