Función SetWinMetaFileBits (wingdi.h)

Artículo
03/13/2024

La función SetWinMetaFileBits convierte un metarchivo del formato anterior de Windows al nuevo formato mejorado y almacena el nuevo metarchivo en memoria.

Sintaxis

HENHMETAFILE SetWinMetaFileBits(
  [in] UINT               nSize,
  [in] const BYTE         *lpMeta16Data,
  [in] HDC                hdcRef,
  [in] const METAFILEPICT *lpMFP
);

Parámetros

[in] nSize

Tamaño, en bytes, del búfer que contiene el metarchivo de formato Windows.

[in] lpMeta16Data

Puntero a un búfer que contiene los datos del metarchivo de formato Windows. (Se supone que los datos se obtuvieron mediante la función GetMetaFileBitsEx o GetWinMetaFileBits ).

[in] hdcRef

Identificador de un contexto de dispositivo de referencia.

[in] lpMFP

Puntero a una estructura METAFILEPICT que contiene el tamaño sugerido de la imagen de metarchivo y el modo de asignación que se usó cuando se creó la imagen.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador para un metarchivo mejorado basado en memoria.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

Windows usa los datos de resolución del contexto del dispositivo de referencia y los datos de la estructura METAFILEPICT para escalar una imagen. Si el parámetro hdcRef es NULL, el sistema usa datos de resolución para el dispositivo de salida actual. Si el parámetro lpmfp es NULL, el sistema usa el modo de asignación de MM_ANISOTROPIC para escalar la imagen de modo que se ajuste a toda la superficie del dispositivo. No se utiliza el miembro hMF de la estructura METAFILEPICT .

Cuando la aplicación ya no necesite el identificador de metarchivo mejorado, debe eliminarlo llamando a la función DeleteEnhMetaFile .

El identificador devuelto por esta función se puede usar con otras funciones de metarchivo mejoradas.

Si el contexto del dispositivo de referencia no es idéntico al dispositivo en el que se creó originalmente el metarchivo, es posible que algunas funciones de GDI que usen unidades de dispositivo no dibujen correctamente la imagen.

Requisitos

Requisito	Value
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