Функция GetWinMetaFileBits (wingdi.h)

Статья
08/27/2023

Функция 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 .

Левый верхний угол изображения метафайла всегда сопоставляется с источником эталонного устройства.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll