Função DrvDescribePixelFormat (winddi.h)

A função DrvDescribePixelFormat descreve o formato de pixel para um PDEV especificado pelo dispositivo escrevendo uma descrição de formato de pixel em uma estrutura PIXELFORMATDESCRIPTOR.

Sintaxe

LONG DrvDescribePixelFormat(
  DHPDEV                dhpdev,
  LONG                  iPixelFormat,
  ULONG                 cjpfd,
  PIXELFORMATDESCRIPTOR *ppfd
);

Parâmetros

dhpdev

Identifica o dispositivo para o qual as informações de formato de pixel são solicitadas.

iPixelFormat

Especifica o número de índice do formato de pixel solicitado.

cjpfd

Especifica o número máximo de bytes que podem ser gravados na estrutura apontada pelo ppfd.

ppfd

Ponteiro para uma estrutura PIXELFORMATDESCRIPTOR (descrita na documentação do SDK do Microsoft Windows) que deve receber informações sobre o formato de pixel. Este parâmetro pode ser NULL.

Valor retornado

O valor retornado será o índice de formato de pixel máximo se a função for bem-sucedida. Caso contrário, será zero e um código de erro será registrado.

Comentários

Um driver de exibição que dá suporte ao hardware gráfico 3D pode dar suporte a janelas com formatos de pixel diferentes em uma única superfície de exibição. O formato de pixel deve corresponder a uma configuração compatível com o hardware gráfico.

DrvDescribePixelFormat preenche a estrutura apontada por ppfd se esse parâmetro não for NULL.

O índice de formato de pixel máximo retornado pode ser usado por aplicativos que precisam obter o índice de formato de pixel máximo de um contexto de dispositivo. Os formatos de pixel compatíveis com um dispositivo são identificados por índices inteiros positivos baseados em um.

As funções de formato de pixel são usadas em conjunto com as funções de serviços de objeto de janela para acompanhar e atualizar formatos de pixel de janelas em uma superfície de exibição.

Requisitos

Plataforma de Destino	Área de Trabalho
Cabeçalho	winddi.h (inclua Winddi.h)