Функция GetMetaFileBitsEx (wingdi.h)
Функция GetMetaFileBitsEx извлекает содержимое метафайла в формате Windows и копирует его в указанный буфер.
Синтаксис
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 |
| Header | wingdi.h (включая Windows.h) |
| Библиотека | Gdi32.lib |
| DLL | Gdi32.dll |