struttura D3DADAPTER_IDENTIFIER9
Contiene informazioni che identificano l'adapter.
Sintassi
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;
Members
-
Driver
-
Tipo: char
-
Utilizzato per la presentazione all'utente. Questo non deve essere usato per identificare determinati driver, perché molte stringhe diverse potrebbero essere associate allo stesso dispositivo e driver di fornitori diversi.
-
Descrizione
-
Tipo: char
-
Utilizzato per la presentazione all'utente.
-
DeviceName
-
Tipo: char
-
Nome del dispositivo per GDI.
-
DriverVersion
-
Tipo: LARGE_INTEGER
-
Identificare la versione del driver Direct3D. È possibile eseguire operazioni minori e maggiori di confronti sul valore intero con segno a 64 bit. Tuttavia, prestare attenzione se si usa questo elemento per identificare i driver problematici. È invece consigliabile usare DeviceIdentifier. Vedere la sezione Osservazioni.
-
DriverVersionLowPart
-
Tipo: DWORD
-
Identificare la versione del driver Direct3D. È possibile eseguire < e > confrontare il valore intero con segno a 64 bit. Tuttavia, prestare attenzione se si usa questo elemento per identificare i driver problematici. È invece consigliabile usare DeviceIdentifier. Vedere la sezione Osservazioni.
-
DriverVersionHighPart
-
Tipo: DWORD
-
Identificare la versione del driver Direct3D. È possibile eseguire < e > confrontare il valore intero con segno a 64 bit. Tuttavia, prestare attenzione se si usa questo elemento per identificare i driver problematici. È invece consigliabile usare DeviceIdentifier. Vedere la sezione Osservazioni.
-
VendorId
-
Tipo: DWORD
-
Può essere usato per identificare un determinato set di chip. Eseguire una query su questo membro per identificare il produttore. Il valore può essere zero se sconosciuto.
-
Deviceid
-
Tipo: DWORD
-
Può essere usato per identificare un determinato set di chip. Eseguire una query su questo membro per identificare il tipo di set di chip. Il valore può essere zero se sconosciuto.
-
SubSysId
-
Tipo: DWORD
-
Può essere usato per identificare un determinato set di chip. Eseguire una query su questo membro per identificare il sottosistema, in genere la scheda specifica. Il valore può essere zero se sconosciuto.
-
Revisione
-
Tipo: DWORD
-
Può essere usato per identificare un determinato set di chip. Eseguire una query su questo membro per identificare il livello di revisione del set di chip. Il valore può essere zero se sconosciuto.
-
DeviceIdentifier
-
Tipo: GUID
-
È possibile eseguire una query per controllare le modifiche nel driver e nel set di chip. Questo GUID è un identificatore univoco per la coppia di driver e set di chip. Eseguire una query su questo membro per tenere traccia delle modifiche apportate al driver e al set di chip per generare un nuovo profilo per il sottosistema grafico. DeviceIdentifier può essere usato anche per identificare determinati driver problematici.
-
WHQLLevel
-
Tipo: DWORD
-
Usato per determinare il livello di convalida di Windows Hardware Quality Labs (WHQL) per questa coppia di driver e dispositivi. DWORD è una struttura di data compressa che definisce la data di rilascio del test WHQL più recente superato dal driver. È legale eseguire < operazioni e > su questo valore. Di seguito viene illustrato il formato della data.
BITS Descrizione 31-16 Anno, numero decimale dal 1999 verso l'alto. 15-8 Mese, numero decimale compreso tra 1 e 12. 7-0 Giorno, numero decimale compreso tra 1 e 31. Vengono usati anche i valori seguenti.
Valore Descrizione 0 Non certificato. 1 WHQL convalidato, ma non sono disponibili informazioni sulla data. Differenze tra Direct3D 9 e Direct3D 9Ex:
Per Direct3D9Ex in esecuzione in Windows Vista, Windows Server 2008, Windows 7 e Windows Server 2008 R2 (o più sistema operativo corrente), IDirect3D9::GetAdapterIdentifier restituisce 1 per il livello WHQL senza controllare lo stato del driver.
Commenti
Nell'esempio di pseudocodice seguente viene illustrato il formato di versione codificato nei membri DriverVersion, DriverVersionLowPart e DriverVersionHighPart.
Product = HIWORD(DriverVersion.HighPart)
Version = LOWORD(DriverVersion.HighPart)
SubVersion = HIWORD(DriverVersion.LowPart)
Build = LOWORD(DriverVersion.LowPart)
Per altre informazioni sulla macro HIWORD, la macro LOWORD e la struttura LARGE_INTEGER, vedere Platform SDK.
MAX_DEVICE_IDENTIFIER_STRING è una costante con la definizione seguente.
#define MAX_DEVICE_IDENTIFIER_STRING 512
I membri VendorId, DeviceId, SubSysId e Revision possono essere usati insieme per identificare set di chip specifici. Tuttavia, usare questi membri con cautela.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
Vedi anche