Partager via


DDDEVICEIDENTIFIER2 structure (ddraw.h)

La structure DDDEVICEIDENTIFIER2 est passée à la méthode IDirectDraw7 ::GetDeviceIdentifier pour obtenir des informations sur un appareil.

Syntaxe

typedef struct tagDDDEVICEIDENTIFIER2 {
  char          szDriver[MAX_DDDEVICEID_STRING];
  char          szDescription[MAX_DDDEVICEID_STRING];
  LARGE_INTEGER liDriverVersion;
  DWORD         dwDriverVersionLowPart;
  DWORD         dwDriverVersionHighPart;
  DWORD         dwVendorId;
  DWORD         dwDeviceId;
  DWORD         dwSubSysId;
  DWORD         dwRevision;
  GUID          guidDeviceIdentifier;
  DWORD         dwWHQLLevel;
} DDDEVICEIDENTIFIER2, *LPDDDEVICEIDENTIFIER2;

Membres

szDriver[MAX_DDDEVICEID_STRING]

Nom du pilote.

szDescription[MAX_DDDEVICEID_STRING]

Description du pilote.

liDriverVersion

Version du pilote. Il est valide de faire moins que et supérieur aux comparaisons sur les 64 bits. Vous devez faire preuve de prudence si vous utilisez cet élément pour identifier les pilotes problématiques ; à la place, utilisez le membre guidDeviceIdentifier à cet effet.

Les données prennent la forme suivante :


wProduct = HIWORD(liDriverVersion.HighPart)
wVersion = LOWORD(liDriverVersion.HighPart)
wSubVersion = HIWORD(liDriverVersion.LowPart)
wBuild = LOWORD(liDriverVersion.LowPart)

dwDriverVersionLowPart

dwDriverVersionHighPart

dwVendorId

Identificateur du fabricant. Peut être 0 si inconnu.

dwDeviceId

Identificateur du type de jeu de puces. Peut être 0 si inconnu.

dwSubSysId

Identificateur du sous-système. En règle générale, cela signifie le tableau particulier. Peut être 0 si inconnu.

dwRevision

Identificateur du niveau de révision du jeu de puces. Peut être 0 si inconnu.

guidDeviceIdentifier

Identificateur unique de la paire pilote-circuit. Utilisez cette valeur si vous souhaitez suivre les modifications apportées au pilote ou au jeu de puces pour reprofiler le sous-système graphique. Il peut également être utilisé pour identifier des pilotes problématiques particuliers.

dwWHQLLevel

Niveau de certification WHQL (Windows Hardware Quality Lab) pour la paire appareil-pilote.

Remarques

Les valeurs dans szDriver et szDescription sont destinées à être présentés à l’utilisateur uniquement. Ils ne doivent pas être utilisés pour identifier des pilotes particuliers, car différentes chaînes peuvent être associées au même appareil, ou le même pilote de fournisseurs différents peut être décrit différemment.

Les membres dwVendorId, dwDeviceId, dwSubSysId et dwRevision peuvent être utilisés pour identifier des puces spécifiques, mais faites preuve d’une extrême prudence.

Configuration requise

Condition requise Valeur
En-tête ddraw.h