Funzione DescribePixelFormat (wingdi.h)

Articolo
03/04/2024

La funzione DescribePixelFormat ottiene informazioni sul formato pixel identificato da iPixelFormat del dispositivo associato a hdc. La funzione imposta i membri della struttura PIXELFORMATDESCRIPTOR puntati da ppfd con i dati in formato pixel.

Sintassi

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

Parametri

hdc

Specifica il contesto del dispositivo.

iPixelFormat

Indice che specifica il formato pixel. I formati di pixel supportati da un contesto del dispositivo sono identificati da indici integer uni-basati su positivi.

nBytes

Dimensioni, in byte, della struttura puntata da ppfd. La funzione DescribePixelFormat archivia non più di n Byte di dati a tale struttura. Impostare questo valore su sizeof(PIXELFORMATDESCRIPTOR).

ppfd

Puntatore a una struttura PIXELFORMATDESCRIPTOR i cui membri vengono impostati con dati di formato pixel. La funzione archivia il numero di byte copiati nella struttura nel membro nSize della struttura. Se, dopo la voce, ppfd è NULL, la funzione scrive nessun dato nella struttura. Ciò è utile solo quando si vuole ottenere l'indice di formato pixel massimo di un contesto del dispositivo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è l'indice di formato pixel massimo del contesto del dispositivo. Inoltre, la funzione imposta i membri della struttura PIXELFORMATDESCRIPTOR puntati da ppfd in base al formato pixel specificato.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h
Libreria	Gdi32.lib
DLL	Gdi32.dll

Vedi anche

Condividi tramite