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