DD_GETEXTENDEDMODEDATA Struktur (d3dhal.h)

  • Artikel

Nur DirectX 9.0 und höhere Versionen.

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

Syntax

typedef struct _DD_GETEXTENDEDMODEDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwModeIndex;
  D3DDISPLAYMODE        mode;
} DD_GETEXTENDEDMODEDATA;

Member

gdi2

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

dwModeIndex

Gibt den Index des zurückzugebenden Anzeigemodus an.

mode

Empfängt eine D3DDISPLAYMODE-Struktur, die den tatsächlichen Anzeigemodus angibt.

Hinweise

Die Laufzeit identifiziert den zurückzugebenden Anzeigemodus mit einem ganzzahligen Index, dessen Wert zwischen null und 1 kleiner als die Anzahl der unterstützten Anzeigemodi variiert, die der Treiber zuvor in einer DD_GETDRIVERINFO2DATA-Abfrage mit dem Typ D3DGDI2_TYPE_GETEXTENDEDMODECOUNT gemeldet hat. Wie diese Indizes tatsächlichen Anzeigemodi zugeordnet werden, bleibt dem Treiber überlassen. Jeder Index muss jedoch eindeutig einem unterstützten Anzeigemodus zugeordnet werden. Die Reihenfolge, in der die Anzeigemodi gemeldet werden, ist nicht signifikant.

Bei der Verarbeitung dieser GetDriverInfo2-Anforderung sollte der Treiber den Wert im dwModeIndex-Element lesen und diesen Wert einem der unterstützten Anzeigemodi zuordnen (wahrscheinlich durch Verwendung des Werts in dwModeIndex als Index in einem Array von D3DDISPLAYMODE Strukturen). Der Treiber sollte dann diesen Anzeigemodus in den Modusmember kopieren. Die Laufzeit garantiert, dass nur ein Index an den Treiber übergeben wird, der im Bereich 0 bis 1 kleiner als die Anzahl der vom Treiber gemeldeten Anzeigemodi liegt. Der Indexbereich sollte im Build des Debugtreibers überprüft werden.

Weitere Informationen zu D3DDISPLAYMODE finden Sie in der DirectX SDK-Dokumentation.

Anforderungen

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

Weitere Informationen

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA

DD_GETEXTENDEDMODECOUNTDATA