DD_GETFORMATDATA Struktur (d3dhal.h)
nur DirectX 8.0 und höhere Versionen.
DD_GETFORMATDATA ist die Datenstruktur, auf die das lpvData- Feld 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;
Angehörige
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.
Bemerkungen
Die Laufzeit identifiziert das Format, das mit einem ganzzahligen Index zurückgegeben werden soll, dessen Wert zwischen Null und 1 kleiner als die Anzahl der vom Treiber zuvor 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 dieses GetDriverInfo2 anfordern, sollte der Treiber die dwFormatIndex- lesen und dies einem der unterstützten Formate zuordnen (wahrscheinlich mithilfe von dwFormatIndex als Index in ein Array von DDPIXELFORMAT-Strukturen) und dann dieses Format in das Formatfeld des felds DD_GETFORMATDATA kopieren. Die Laufzeit garantiert, dass sie nur einen Index an den Treiber übergibt, der sich im Bereich Null befindet, auf einen kleiner als die Anzahl der vom Treiber gemeldeten Oberflächenformate. Der Indexbereich sollte im Debugtreiberbuild überprüft werden.
nur DirectX 9.0 und höhere Versionen.On input, the version of the DirectX runtime that is used by the application is specified in the dwSize member of the DDPIXELFORMAT structure in format. Dieser dwSize Member ist auf DD_RUNTIME_VERSION festgelegt, was für DirectX 9.0 0x00000900 ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | d3dhal.h (einschließlich D3dhal.h) |