DescribePixelFormat-Funktion (wingdi.h)
Die DescribePixelFormat-Funktion ruft Informationen über das Pixelformat ab, das durch iPixelFormat des geräts identifiziert wird, das hdc zugeordnet ist. Die Funktion legt die Member der PIXELFORMATDESCRIPTOR-Struktur fest, auf die ppfd mit diesen Pixelformatdaten verweist.
Syntax
int DescribePixelFormat(
HDC hdc,
int iPixelFormat,
UINT nBytes,
LPPIXELFORMATDESCRIPTOR ppfd
);
Parameter
hdc
Gibt den Gerätekontext an.
iPixelFormat
Index, der das Pixelformat angibt. Die Pixelformate, die ein Gerätekontext unterstützt, werden durch positive 1-basierte ganzzahlige Indizes identifiziert.
nBytes
Die Größe der Struktur in Bytes, auf die ppfd verweist. Die DescribePixelFormat-Funktion speichert nicht mehr als nByte An Daten in dieser Struktur. Legen Sie diesen Wert auf sizeof(PIXELFORMATDESCRIPTOR) fest.
ppfd
Zeiger auf eine PIXELFORMATDESCRIPTOR-Struktur , deren Member die Funktion mit Pixelformatdaten festlegt. Die Funktion speichert die Anzahl der Bytes, die in die Struktur im nSize-Element der Struktur kopiert wurden. Wenn ppfd bei der Eingabe NULL ist, schreibt die Funktion keine Daten in die -Struktur. Dies ist nützlich, wenn Sie nur den maximalen Pixelformatindex eines Gerätekontexts abrufen möchten.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der maximale Pixelformatindex des Gerätekontexts. Darüber hinaus legt die Funktion die Member der PIXELFORMATDESCRIPTOR-Struktur fest, auf die von ppfd gemäß dem angegebenen Pixelformat verwiesen wird.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |