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
| Anforderung | Wert |
|---|---|
| Header |
|
Siehe auch