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) |