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