Funzione DrvDescribePixelFormat (winddi.h)

La funzione DrvDescribePixelFormat descrive il formato pixel per un PDEV specificato dal dispositivo scrivendo una descrizione del formato pixel in una struttura PIXELFORMATDESCRIPTOR.

Sintassi

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

Parametri

dhpdev

Identifica il dispositivo per cui vengono richieste informazioni sul formato pixel.

iPixelFormat

Specifica il numero di indice del formato pixel richiesto.

cjpfd

Specifica il numero massimo di byte che è possibile scrivere nella struttura a cui punta ppfd.

ppfd

Puntatore a una struttura PIXELFORMATDESCRIPTOR (descritta nella documentazione di Microsoft Windows SDK) che deve ricevere informazioni sul formato pixel. Questo parametro può essere NULL.

Valore restituito

Il valore restituito è l'indice di formato pixel massimo se la funzione ha esito positivo. In caso contrario, è zero e viene registrato un codice di errore.

Commenti

Un driver di visualizzazione che supporta l'hardware grafico 3D può supportare finestre con formati pixel diversi su una singola superficie di visualizzazione. Il formato pixel deve corrispondere a una configurazione supportata dall'hardware grafico.

DrvDescribePixelFormat riempie la struttura a cui punta ppfd se questo parametro non è NULL.

L'indice di formato pixel massimo restituito può essere usato dalle applicazioni che devono ottenere l'indice di formato pixel massimo di un contesto di dispositivo. I formati pixel supportati da un dispositivo sono identificati da indici interi positivi a una base.

Le funzioni di formato pixel vengono usate insieme alle funzioni dei servizi oggetti finestra per tenere traccia e aggiornare i formati pixel delle finestre in una superficie di visualizzazione.

Requisiti