Função GetWinMetaFileBits (wingdi.h)
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 |