D3DADAPTER_IDENTIFIER9 structure

  • Article

Contient des informations identifiant l’adaptateur.

Syntaxe

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;

Membres

Driver

Type : char

Utilisé pour la présentation à l’utilisateur. Cela ne doit pas être utilisé pour identifier des pilotes particuliers, car de nombreuses chaînes différentes peuvent être associées au même périphérique et au même pilote de fournisseurs différents.

Description

Type : char

Utilisé pour la présentation à l’utilisateur.

DeviceName

Type : char

Nom de l’appareil pour GDI.

DriverVersion

Type : LARGE_INTEGER

Identifiez la version du pilote Direct3D. Il est légal d’effectuer des comparaisons inférieures à et supérieures à la valeur entière signée 64 bits. Toutefois, soyez prudent si vous utilisez cet élément pour identifier les pilotes problématiques. Au lieu de cela, vous devez utiliser DeviceIdentifier. Consultez la section Notes.

DriverVersionLowPart

Type : DWORD

Identifiez la version du pilote Direct3D. Il est légal d’effectuer < des comparaisons et > sur la valeur entière signée 64 bits. Toutefois, soyez prudent si vous utilisez cet élément pour identifier les pilotes problématiques. Au lieu de cela, vous devez utiliser DeviceIdentifier. Consultez la section Notes.

DriverVersionHighPart

Type : DWORD

Identifiez la version du pilote Direct3D. Il est légal d’effectuer < des comparaisons et > sur la valeur entière signée 64 bits. Toutefois, soyez prudent si vous utilisez cet élément pour identifier les pilotes problématiques. Au lieu de cela, vous devez utiliser DeviceIdentifier. Consultez la section Notes.

VendorId

Type : DWORD

Peut être utilisé pour aider à identifier un ensemble de puces particulier. Interrogez ce membre pour identifier le fabricant. La valeur peut être égale à zéro si elle est inconnue.

DeviceId

Type : DWORD

Peut être utilisé pour aider à identifier un ensemble de puces particulier. Interrogez ce membre pour identifier le type de jeu de puces. La valeur peut être égale à zéro si elle est inconnue.

SubSysId

Type : DWORD

Peut être utilisé pour aider à identifier un ensemble de puces particulier. Interrogez ce membre pour identifier le sous-système, généralement le tableau particulier. La valeur peut être égale à zéro si elle est inconnue.

Revision

Type : DWORD

Peut être utilisé pour aider à identifier un ensemble de puces particulier. Interrogez ce membre pour identifier le niveau de révision du jeu de puces. La valeur peut être égale à zéro si elle est inconnue.

DeviceIdentifier

Type : GUID

Peut être interrogé pour case activée modifications dans le pilote et le jeu de puces. Ce GUID est un identificateur unique pour la paire de pilotes et de puces. Interrogez ce membre pour suivre les modifications apportées au pilote et au jeu de puces afin de générer un nouveau profil pour le sous-système graphique. DeviceIdentifier peut également être utilisé pour identifier des pilotes problématiques particuliers.

WHQLLevel

Type : DWORD

Permet de déterminer le niveau de validation WHQL (Windows Hardware Quality Labs) pour cette paire de pilotes et de périphériques. DWORD est une structure de dates packed définissant la date de publication du test WHQL le plus récent réussi par le pilote. Il est légal d’effectuer < des opérations et > sur cette valeur. L’exemple suivant illustre le format de date.

Bits Description
31-16 L’année, nombre décimal à partir de 1999.
15-8 Le mois, nombre décimal compris entre 1 et 12.
7-0 Le jour, nombre décimal compris entre 1 et 31.

 

Les valeurs suivantes sont également utilisées.

Valeur Description
0 Non certifié.
1 WHQL validé, mais aucune information de date n’est disponible.

 

Différences entre Direct3D 9 et Direct3D 9Ex :

Pour Direct3D9Ex s’exécutant sur Windows Vista, Windows Server 2008, Windows 7 et Windows Server 2008 R2 (ou un système d’exploitation plus actuel), IDirect3D9::GetAdapterIdentifier retourne 1 pour le niveau WHQL sans vérifier la status du pilote.

Notes

L’exemple de pseudo-code suivant illustre le format de version encodé dans les membres DriverVersion, DriverVersionLowPart et DriverVersionHighPart.

Product = HIWORD(DriverVersion.HighPart)
Version = LOWORD(DriverVersion.HighPart)
SubVersion = HIWORD(DriverVersion.LowPart)
Build = LOWORD(DriverVersion.LowPart)

Pour plus d’informations sur la macro HIWORD, la macro LOWORD et la structure LARGE_INTEGER, consultez le Kit de développement logiciel (SDK) de plateforme.

MAX_DEVICE_IDENTIFIER_STRING est une constante avec la définition suivante.

#define MAX_DEVICE_IDENTIFIER_STRING        512

Les membres VendorId, DeviceId, SubSysId et Revision peuvent être utilisés conjointement pour identifier des ensembles de puces spécifiques. Toutefois, utilisez ces membres avec précaution.

Spécifications

Condition requise Valeur
En-tête
D3D9Types.h

Voir aussi

Direct3D Structures