Funzione DescribePixelFormat (wingdi.h)
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 |