D3DADAPTER _ IDENTIFIER9-Struktur

Enthält Informationen zum Identifizieren 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 Darstellung für den Benutzer verwendet. Dies sollte nicht verwendet werden, um bestimmte Treiber zu identifizieren, da viele verschiedene Zeichenfolgen dem gleichen Gerät und Treiber von verschiedenen Anbietern zugeordnet sein können.

Beschreibung

Typ: char

Wird für die Darstellung 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, vergleicht den 64-Bit-Ganzzahlwert mit Vorzeichen kleiner als und größer als zu vergleichen. 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 zulässig, < und > Vergleiche für den 64-Bit-Ganzzahlwert mit Vorzeichen zu machen. 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 zulässig, < und > Vergleiche für den 64-Bit-Ganzzahlwert mit Vorzeichen zu machen. 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 0 (null) sein, wenn er unbekannt ist.

DeviceId

Typ: DWORD

Kann verwendet werden, um einen bestimmten Chipsatz zu identifizieren. Fragen Sie diesen Member ab, um den Typ des Chipsatzes zu identifizieren. Der Wert kann 0 (null) sein, wenn er unbekannt ist.

SubSysId

Typ: DWORD

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

Revision

Typ: DWORD

Kann verwendet werden, um einen bestimmten Chipsatz zu identifizieren. Fragen Sie diesen Member ab, um die Revisionsebene des Chipsatzes zu identifizieren. Der Wert kann 0 (null) sein, wenn er unbekannt ist.

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 diesen Member 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 WHQL-Überprüfungsebene (Hardware Quality Labs) für dieses Treiber- und Gerätepaar zu bestimmen. Das DWORD ist eine gepackte Datumsstruktur, die das Datum der Veröffentlichung des letzten vom Treiber bestandenen WHQL-Tests definiert. Es ist zulässig, < und > Vorgänge für diesen Wert 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 zwischen 1 und 12.
7-0 Der Tag, eine Dezimalzahl von 1 bis 31.

Die folgenden Werte werden ebenfalls verwendet.

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

Unterschiede zwischen Direct3D 9 und Direct3D 9Ex:

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

Hinweise

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 zusammen verwendet werden, um bestimmte Chipsätze zu identifizieren. Verwenden Sie diese Member jedoch mit Vorsicht.

Anforderungen

Anforderung Wert
Header
D3D9Types.h

Siehe auch

Direct3D-Strukturen