Función GetWinMetaFileBits (wingdi.h)

  • Artículo

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

Consulte también

DeleteEnhMetaFile

Funciones de metarchivo

Introducción a los metarchivos

SetMapMode

SetWinMetaFileBits