estructura DDDEVICEIDENTIFIER2 (ddraw.h)

La estructura DDDEVICEIDENTIFIER2 se pasa al método IDirectDraw7::GetDeviceIdentifier para obtener información sobre un dispositivo.

Sintaxis

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;

Miembros

szDriver[MAX_DDDEVICEID_STRING]

Nombre del controlador.

szDescription[MAX_DDDEVICEID_STRING]

Descripción del controlador.

liDriverVersion

Versión del controlador. Es válido hacer menos que y mayor que las comparaciones en todos los 64 bits. Se debe tener precaución si usa este elemento para identificar controladores problemáticos; en su lugar, use el miembro guidDeviceIdentifier para este propósito.

Los datos tienen la siguiente forma:

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

dwDriverVersionLowPart

dwDriverVersionHighPart

dwVendorId

Identificador del fabricante. Puede ser 0 si se desconoce.

dwDeviceId

Identificador del tipo de conjunto de chips. Puede ser 0 si se desconoce.

dwSubSysId

Identificador del subsistema. Normalmente, esto significa la placa concreta. Puede ser 0 si se desconoce.

dwRevision

Identificador del nivel de revisión del conjunto de chips. Puede ser 0 si se desconoce.

guidDeviceIdentifier

Identificador único para el controlador y el par de conjuntos de chips. Use este valor si desea realizar un seguimiento de los cambios en el controlador o conjunto de chips para volver a crear el subsistema de gráficos. También se puede usar para identificar controladores problemáticos concretos.

dwWHQLLevel

Nivel de certificación de Windows Hardware Quality Lab (WHQL) para el par de controladores y dispositivos.

Comentarios

Los valores de szDriver y szDescription son solo para la presentación al usuario. No deben usarse para identificar controladores concretos porque es posible que se asoficien cadenas diferentes con el mismo dispositivo o que el mismo controlador de distintos proveedores se pueda describir de forma diferente.

Los miembros dwVendorId, dwDeviceId, dwSubSysId y dwRevision se pueden usar para identificar conjuntos de chips concretos, pero tenga extrema precaución.

Requisitos