DD_GETFORMATDATA Struktur (d3dhal.h)

Nur DirectX 8.0 und höhere Versionen.

DD_GETFORMATDATA ist die Datenstruktur, auf die das lpvData-Feld von DD_GETDRIVERINFODATA für DD_GETDRIVERINFO2DATA Abfragen mit dem Typ D3DGDI2_TYPE_GETFORMAT verweist.

Syntax

typedef struct _DD_GETFORMATDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwFormatIndex;
  DDPIXELFORMAT         format;
} DD_GETFORMATDATA;

Member

gdi2

Gibt eine DD_GETDRIVERINFO2DATA-Struktur an, die die GetDriverInfo2-Daten enthält.

dwFormatIndex

Gibt den Index des zurückzugebenden Pixelformats an.

format

Empfängt das tatsächliche Pixelformat in einer DDPIXELFORMAT-Struktur .

Hinweise

Die Runtime identifiziert das zurückzugebende Format mit einem ganzzahligen Index, dessen Wert zwischen null und eins kleiner als die Anzahl der zuvor vom Treiber gemeldeten unterstützten Formate variiert. Wie diese Indizes tatsächlichen Formaten zugeordnet werden, bleibt dem Treiber überlassen. Jeder Index muss jedoch einem unterstützten Format eindeutig zugeordnet werden. Die Reihenfolge, in der die Formate gemeldet werden, ist nicht signifikant.

Bei der Verarbeitung dieser GetDriverInfo2-Anforderung sollte der Treiber dwFormatIndex lesen und einem der unterstützten Formate zuordnen (wahrscheinlich durch Verwendung von dwFormatIndex als Index in ein Array von DDPIXELFORMAT-Strukturen) und dann dieses Format in das Formatfeld des DD_GETFORMATDATA Felds kopieren. Die Runtime garantiert, dass nur ein Index an den Treiber übergeben wird, der im Bereich 0 bis eins kleiner als die Anzahl der vom Treiber gemeldeten Oberflächenformate liegt. Der Indexbereich sollte im Build des Debugtreibers überprüft werden.

Nur DirectX 9.0 und höhere Versionen.Bei der Eingabe wird die Version der DirectX-Runtime, die von der Anwendung verwendet wird, im dwSize-Element der DDPIXELFORMAT-Struktur im Format angegeben. Dieser dwSize-Member ist auf DD_RUNTIME_VERSION festgelegt, was für DirectX 9.0 0x00000900 ist.

Anforderungen

Anforderung	Wert
Header	d3dhal.h (include D3dhal.h)

Weitere Informationen

DDPIXELFORMAT

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA