Función GetWinMetaFileBits (wingdi.h)
La función GetWinMetaFileBits convierte los registros de formato mejorado de un metarchivo en registros de formato Windows y almacena los registros convertidos en el búfer especificado.
Sintaxis
UINT GetWinMetaFileBits(
[in] HENHMETAFILE hemf,
[in] UINT cbData16,
[out] LPBYTE pData16,
[in] INT iMapMode,
[in] HDC hdcRef
);
Parámetros
[in] hemf
Identificador del metarchivo mejorado.
[in] cbData16
Tamaño, en bytes, del búfer en el que se van a copiar los registros convertidos.
[out] pData16
Puntero al búfer que recibe los registros convertidos. Si lpbBuffer es NULL, GetWinMetaFileBits devuelve el número de bytes necesarios para almacenar los registros de metarchivo convertidos.
[in] iMapMode
Modo de asignación que se va a usar en el metarchivo convertido.
[in] hdcRef
Identificador del contexto del dispositivo de referencia.
Valor devuelto
Si la función se ejecuta correctamente y el puntero del búfer es NULL, el valor devuelto es el número de bytes necesarios para almacenar los registros convertidos; si la función se ejecuta correctamente y el puntero del búfer es un puntero válido, el valor devuelto es el tamaño de los datos del metarchivo en bytes.
Si la función no se realiza correctamente, el valor devuelto es cero.
Comentarios
Esta función convierte un metarchivo mejorado en un metarchivo de formato Windows para que su imagen se pueda mostrar en una aplicación que reconozca el formato anterior.
El sistema usa el contexto del dispositivo de referencia para determinar la resolución del metarchivo convertido.
La función GetWinMetaFileBits no invalida el identificador de metarchivo mejorado. Una aplicación debe llamar a la función DeleteEnhMetaFile para liberar el identificador cuando ya no sea necesario.
Para crear un metarchivo de formato Windows escalable, especifique MM_ANISOTROPIC como parámetro fnMapMode .
La esquina superior izquierda de la imagen del metarchivo siempre se asigna al origen del dispositivo de referencia.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wingdi.h (incluye Windows.h) |
| Library | Gdi32.lib |
| Archivo DLL | Gdi32.dll |