Função GetWinMetaFileBits (wingdi.h)

Artigo
08/27/2023

A função GetWinMetaFileBits converte os registros de formato aprimorado de um metarquivo em registros no formato Windows e armazena os registros convertidos no buffer especificado.

Sintaxe

UINT GetWinMetaFileBits(
  [in]  HENHMETAFILE hemf,
  [in]  UINT         cbData16,
  [out] LPBYTE       pData16,
  [in]  INT          iMapMode,
  [in]  HDC          hdcRef
);

Parâmetros

[in] hemf

Um identificador para o metarquivo aprimorado.

[in] cbData16

O tamanho, em bytes, do buffer no qual os registros convertidos devem ser copiados.

[out] pData16

Um ponteiro para o buffer que recebe os registros convertidos. Se lpbBuffer for NULL, GetWinMetaFileBits retornará o número de bytes necessários para armazenar os registros de meta-arquivo convertidos.

[in] iMapMode

O modo de mapeamento a ser usado no metarquivo convertido.

[in] hdcRef

Um identificador para o contexto do dispositivo de referência.

Valor retornado

Se a função for bem-sucedida e o ponteiro do buffer for NULL, o valor retornado será o número de bytes necessários para armazenar os registros convertidos; se a função for bem-sucedida e o ponteiro do buffer for um ponteiro válido, o valor retornado será o tamanho dos dados de meta-arquivo em bytes.

Se a função falhar, o valor retornado será zero.

Comentários

Essa função converte um metarquivo aprimorado em um metarquivo no formato windows para que sua imagem possa ser exibida em um aplicativo que reconhece o formato mais antigo.

O sistema usa o contexto do dispositivo de referência para determinar a resolução do meta-arquivo convertido.

A função GetWinMetaFileBits não invalida o identificador de meta-arquivo aprimorado. Um aplicativo deve chamar a função DeleteEnhMetaFile para liberar o identificador quando ele não for mais necessário.

Para criar um metarquivo escalonável no formato Windows, especifique MM_ANISOTROPIC como o parâmetro fnMapMode .

O canto superior esquerdo da imagem de metarquivo é sempre mapeado para a origem do dispositivo de referência.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll