Função DescribePixelFormat (wingdi.h)

Artigo
03/04/2024

A função DescribePixelFormat obtém informações sobre o formato de pixel identificado por iPixelFormat do dispositivo associado ao hdc. A função define os membros da estrutura PIXELFORMATDESCRIPTOR apontada por ppfd com esses dados de formato de pixel.

Sintaxe

int DescribePixelFormat(
  HDC                     hdc,
  int                     iPixelFormat,
  UINT                    nBytes,
  LPPIXELFORMATDESCRIPTOR ppfd
);

Parâmetros

hdc

Especifica o contexto de dispositivo.

iPixelFormat

Índice que especifica o formato de pixel. Os formatos de pixel compatíveis com um contexto de dispositivo são identificados por índices inteiros positivos baseados em um.

nBytes

O tamanho, em bytes, da estrutura apontada pelo ppfd. A função DescribePixelFormat armazena no máximo nBytes bytes de dados nessa estrutura. Defina esse valor como sizeof(PIXELFORMATDESCRIPTOR).

ppfd

Ponteiro para uma estrutura PIXELFORMATDESCRIPTOR cujos membros a função define com dados de formato de pixel. A função armazena o número de bytes copiados para a estrutura no membro nSize da estrutura. Se, após a entrada, ppfd for NULL, a função não gravará nenhum dado na estrutura. Isso é útil quando você só deseja obter o índice de formato de pixel máximo de um contexto de dispositivo.

Retornar valor

Se a função for bem-sucedida, o valor retornado será o índice de formato de pixel máximo do contexto do dispositivo. Além disso, a função define os membros da estrutura PIXELFORMATDESCRIPTOR apontada pelo ppfd de acordo com o formato de pixel especificado.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

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

Compartilhar via