struttura D3DADAPTER_IDENTIFIER9

  • Articolo

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
D3D9Types.h

Vedi anche

Strutture Direct3D