Função GetEnhMetaFilePixelFormat (wingdi.h)
A função GetEnhMetaFilePixelFormat recupera informações de formato de pixel para um metarquivo aprimorado.
Sintaxe
UINT GetEnhMetaFilePixelFormat(
HENHMETAFILE hemf,
UINT cbBuffer,
PIXELFORMATDESCRIPTOR *ppfd
);
Parâmetros
hemf
Identifica o meta-arquivo aprimorado.
cbBuffer
Especifica o tamanho, em bytes, do buffer no qual as informações de formato de pixel são copiadas.
ppfd
Ponteiro para uma estrutura PIXELFORMATDESCRIPTOR que contém a especificação de formato de pixel lógico. O metarquivo usa essa estrutura para registrar a especificação de formato de pixel lógico.
Retornar valor
Se a função for bem-sucedida e encontrar um formato de pixel, o valor retornado será o tamanho do formato de pixel do metafile.
Se nenhum formato de pixel estiver presente, o valor retornado será zero.
Se ocorrer um erro e a função falhar, o valor retornado será GDI_ERROR. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Quando um metarquivo aprimorado especifica um formato de pixel em sua estrutura ENHMETAHEADER e o formato de pixel se encaixa no buffer, as informações de formato de pixel são copiadas para ppfd. Quando cbBuffer é muito pequeno para conter o formato de pixel do metarquivo, o formato de pixel não é copiado para o buffer. Em ambos os casos, a função retorna o tamanho do formato de pixel do metarquivo.
Para obter informações sobre gravação de metafile e outras operações, consulte Operações avançadas de metarquivo.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |
| Biblioteca | Gdi32.lib |
| DLL | Gdi32.dll |