D3DADAPTER_IDENTIFIER9 Struktur

Enthält Informationen zur Identifizierung des Adapters.

Syntax

typedef struct D3DADAPTER_IDENTIFIER9 {
  char          Driver[MAX_DEVICE_IDENTIFIER_STRING];
  char          Description[MAX_DEVICE_IDENTIFIER_STRING];
  char          DeviceName[32];
#ifdef _WIN32
  LARGE_INTEGER DriverVersion;
#else
  DWORD         DriverVersionLowPart;
  DWORD         DriverVersionHighPart;
#endif
  DWORD         VendorId;
  DWORD         DeviceId;
  DWORD         SubSysId;
  DWORD         Revision;
  GUID          DeviceIdentifier;
  DWORD         WHQLLevel;
} D3DADAPTER_IDENTIFIER9, *LPD3DADAPTER_IDENTIFIER9;

Member

Treiber

Typ: char

Wird für die Präsentation für den Benutzer verwendet. Dies sollte nicht verwendet werden, um bestimmte Treiber zu identifizieren, da viele verschiedene Zeichenfolgen demselben Gerät und Treiber von verschiedenen Anbietern zugeordnet sein können.

Beschreibung

Typ: char

Wird für die Präsentation für den Benutzer verwendet.

DeviceName

Typ: char

Gerätename für GDI.

DriverVersion

Typ: LARGE_INTEGER

Identifizieren Sie die Version des Direct3D-Treibers. Es ist zulässig, für den 64-Bit-Ganzzahlwert mit Vorzeichen kleiner und größer als Vergleiche durchzuführen. Seien Sie jedoch vorsichtig, wenn Sie dieses Element verwenden, um problematische Treiber zu identifizieren. Stattdessen sollten Sie DeviceIdentifier verwenden. Siehe Hinweise.

DriverVersionLowPart

Typ: DWORD

Identifizieren Sie die Version des Direct3D-Treibers. Es ist legal, < und > Vergleiche für den 64-Bit-Ganzzahlwert mit Vorzeichen durchzuführen. Seien Sie jedoch vorsichtig, wenn Sie dieses Element verwenden, um problematische Treiber zu identifizieren. Stattdessen sollten Sie DeviceIdentifier verwenden. Siehe Hinweise.

DriverVersionHighPart

Typ: DWORD

Identifizieren Sie die Version des Direct3D-Treibers. Es ist legal, < und > Vergleiche für den 64-Bit-Ganzzahlwert mit Vorzeichen durchzuführen. Seien Sie jedoch vorsichtig, wenn Sie dieses Element verwenden, um problematische Treiber zu identifizieren. Stattdessen sollten Sie DeviceIdentifier verwenden. Siehe Hinweise.

VendorId

Typ: DWORD

Kann verwendet werden, um einen bestimmten Chipsatz zu identifizieren. Fragen Sie dieses Element ab, um den Hersteller zu identifizieren. Der Wert kann null sein, wenn unbekannt.

DeviceId

Typ: DWORD

Kann verwendet werden, um einen bestimmten Chipsatz zu identifizieren. Fragen Sie dieses Element ab, um den Typ des Chipsatzes zu identifizieren. Der Wert kann null sein, wenn unbekannt.

SubSysId

Typ: DWORD

Kann verwendet werden, um einen bestimmten Chipsatz zu identifizieren. Fragen Sie dieses Member ab, um das Subsystem zu identifizieren, in der Regel das jeweilige Board. Der Wert kann null sein, wenn unbekannt.

Revision

Typ: DWORD

Kann verwendet werden, um einen bestimmten Chipsatz zu identifizieren. Fragen Sie dieses Element ab, um die Revisionsebene des Chipsatzes zu identifizieren. Der Wert kann null sein, wenn unbekannt.

DeviceIdentifier

Typ: GUID

Kann abgefragt werden, um Änderungen im Treiber und Chipsatz zu überprüfen. Diese GUID ist ein eindeutiger Bezeichner für das Treiber- und Chipsatzpaar. Fragen Sie dieses Element ab, um Änderungen am Treiber und Chipsatz nachzuverfolgen, um ein neues Profil für das Grafiksubsystem zu generieren. DeviceIdentifier kann auch verwendet werden, um bestimmte problematische Treiber zu identifizieren.

WHQLLevel

Typ: DWORD

Wird verwendet, um die Windows Hardware Quality Labs (WHQL)-Validierungsstufe für dieses Treiber- und Gerätepaar zu bestimmen. Die DWORD ist eine gepackte Datumsstruktur, die das Datum der Veröffentlichung des letzten WHQL-Tests definiert, der vom Treiber bestanden wurde. Es ist legal, für diesen Wert Vorgänge auszuführen<.> Im Folgenden wird das Datumsformat veranschaulicht.

Bits	BESCHREIBUNG
31-16	Das Jahr, eine Dezimalzahl ab 1999 aufwärts.
15-8	Der Monat, eine Dezimalzahl von 1 bis 12.
7-0	Der Tag, eine Dezimalzahl von 1 bis 31.

 

Die folgenden Werte werden ebenfalls verwendet.

Wert	BESCHREIBUNG
0	Nicht zertifiziert.
1	WHQL wurde überprüft, aber es sind keine Datumsinformationen verfügbar.

 

Unterschiede zwischen Direct3D 9 und Direct3D 9Ex:

Bei Direct3D9Ex unter Windows Vista, Windows Server 2008, Windows 7 und Windows Server 2008 R2 (oder einem aktuelleren Betriebssystem) gibt IDirect3D9::GetAdapterIdentifier 1 für die WHQL-Ebene zurück, ohne die status des Treibers zu überprüfen.

Bemerkungen

Das folgende Pseudocodebeispiel veranschaulicht das Versionsformat, das in den Membern DriverVersion, DriverVersionLowPart und DriverVersionHighPart codiert ist.

Product = HIWORD(DriverVersion.HighPart)
Version = LOWORD(DriverVersion.HighPart)
SubVersion = HIWORD(DriverVersion.LowPart)
Build = LOWORD(DriverVersion.LowPart)

Weitere Informationen zum HIWORD-Makro, zum LOWORD-Makro und zur LARGE_INTEGER-Struktur finden Sie im Platform SDK.

MAX_DEVICE_IDENTIFIER_STRING ist eine Konstante mit der folgenden Definition.

#define MAX_DEVICE_IDENTIFIER_STRING        512

Die Member VendorId, DeviceId, SubSysId und Revision können gleichzeitig verwendet werden, um bestimmte Chipsätze zu identifizieren. Verwenden Sie diese Member jedoch mit Vorsicht.

Anforderungen

Siehe auch

Direct3D-Strukturen