DrvDescribePixelFormat-Funktion (winddi.h)

Die DrvDescribePixelFormat-Funktion beschreibt das Pixelformat für ein vom Gerät angegebenes PDEV , indem eine Pixelformatbeschreibung in eine PIXELFORMATDESCRIPTOR-Struktur geschrieben wird.

Syntax

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

Parameter

dhpdev

Gibt das Gerät an, für das Pixelformatinformationen angefordert werden.

iPixelFormat

Gibt die Indexnummer des angeforderten Pixelformats an.

cjpfd

Gibt die maximale Anzahl von Bytes an, die in die Struktur geschrieben werden können, auf die ppfd verweist.

ppfd

Zeiger auf eine PIXELFORMATDESCRIPTOR-Struktur (in der Microsoft Windows SDK-Dokumentation beschrieben), die Informationen zum Pixelformat empfangen soll. Dieser Parameter kann NULL sein.

Rückgabewert

Der Rückgabewert ist der maximale Pixelformatindex, wenn die Funktion erfolgreich ist. Andernfalls ist er 0, und ein Fehlercode wird protokolliert.

Hinweise

Ein Anzeigetreiber, der 3D-Grafikhardware unterstützt, kann Fenster mit unterschiedlichen Pixelformaten auf einer einzelnen Anzeigeoberfläche unterstützen. Das Pixelformat muss einer konfiguration entsprechen, die von der Grafikhardware unterstützt wird.

DrvDescribePixelFormat füllt die Struktur aus, auf die ppfd verweist, wenn dieser Parameter nicht NULL ist.

Der zurückgegebene maximale Pixelformatindex kann von Anwendungen verwendet werden, die den maximalen Pixelformatindex eines Gerätekontexts abrufen müssen. Die von einem Gerät unterstützten Pixelformate werden durch positive 1-basierte ganzzahlige Indizes identifiziert.

Die Pixelformatfunktionen werden in Verbindung mit den Funktionen der Fensterobjektdienste verwendet, um Pixelformate von Fenstern auf einer Anzeigeoberfläche nachzuverfolgen und zu aktualisieren.

Anforderungen

Zielplattform	Desktop
Kopfzeile	winddi.h (einschließlich Winddi.h)