Compartilhar via

Função GetEnhMetaFilePixelFormat (wingdi.h)

  • Artigo

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

Confira também

ENHMETAHEADER

OpenGL no Windows

PIXELFORMATDESCRIPTOR

Funções do Windows