GetWinMetaFileBits 函数 (wingdi.h)

GetWinMetaFileBits 函数将增强格式的记录从图元文件转换为 Windows 格式记录，并将转换后的记录存储在指定的缓冲区中。

语法

UINT GetWinMetaFileBits(
  [in]  HENHMETAFILE hemf,
  [in]  UINT         cbData16,
  [out] LPBYTE       pData16,
  [in]  INT          iMapMode,
  [in]  HDC          hdcRef
);

参数

[in] hemf

增强型图元文件的句柄。

[in] cbData16

转换后的记录要复制到的缓冲区的大小（以字节为单位）。

[out] pData16

指向接收转换后的记录的缓冲区的指针。 如果 lpbBuffer 为 NULL， GetWinMetaFileBits 将返回存储转换后的图元文件记录所需的字节数。

[in] iMapMode

在转换后的图元文件中使用的映射模式。

[in] hdcRef

引用设备上下文的句柄。

返回值

如果函数成功且缓冲区指针为 NULL，则返回值是存储转换的记录所需的字节数：如果函数成功，并且缓冲区指针是有效的指针，则返回值是图元文件数据的大小（以字节为单位）。

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

注解

此函数将增强的图元文件转换为 Windows 格式的图元文件，以便其图片可以在识别旧格式的应用程序中显示。

系统使用引用设备上下文来确定转换后的图元文件的分辨率。

GetWinMetaFileBits 函数不会使增强的图元文件句柄失效。 应用程序应调用 DeleteEnhMetaFile 函数，以在不再需要句柄时释放该句柄。

若要创建可缩放的 Windows 格式图元文件，请将 MM_ANISOTROPIC 指定为 fnMapMode 参数。

图元文件图片的左上角始终映射到引用设备的原点。

要求

另请参阅

DeleteEnhMetaFile

图元文件函数

图元文件概述

SetMapMode

SetWinMetaFileBits