estructura de D3DADAPTER_IDENTIFIER9

  • Artículo

Contiene información que identifica el adaptador.

Sintaxis

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;

Miembros

Controlador

Tipo: char

Se usa para la presentación al usuario. Esto no se debe usar para identificar controladores concretos, ya que es posible que muchas cadenas diferentes estén asociadas con el mismo dispositivo y controlador de distintos proveedores.

Descripción

Tipo: char

Se usa para la presentación al usuario.

DeviceName

Tipo: char

Nombre del dispositivo para GDI.

DriverVersion

Tipo: LARGE_INTEGER

Identifique la versión del controlador Direct3D. Es legal hacer menos que y mayor que las comparaciones en el valor entero de 64 bits con signo. Sin embargo, tenga cuidado si usa este elemento para identificar controladores problemáticos. En su lugar, debe usar DeviceIdentifier. Vea la sección Comentarios.

DriverVersionLowPart

Tipo: DWORD

Identifique la versión del controlador Direct3D. Es legal realizar < comparaciones > en el valor entero de 64 bits con signo. Sin embargo, tenga cuidado si usa este elemento para identificar controladores problemáticos. En su lugar, debe usar DeviceIdentifier. Vea la sección Comentarios.

DriverVersionHighPart

Tipo: DWORD

Identifique la versión del controlador Direct3D. Es legal realizar < comparaciones > en el valor entero de 64 bits con signo. Sin embargo, tenga cuidado si usa este elemento para identificar controladores problemáticos. En su lugar, debe usar DeviceIdentifier. Vea la sección Comentarios.

VendorId

Tipo: DWORD

Se puede usar para ayudar a identificar un conjunto de chip determinado. Consulte a este miembro para identificar al fabricante. El valor puede ser cero si se desconoce.

DeviceId

Tipo: DWORD

Se puede usar para ayudar a identificar un conjunto de chip determinado. Consulte a este miembro para identificar el tipo de conjunto de chip. El valor puede ser cero si se desconoce.

SubSysId

Tipo: DWORD

Se puede usar para ayudar a identificar un conjunto de chip determinado. Consulte a este miembro para identificar el subsistema, normalmente la placa concreta. El valor puede ser cero si se desconoce.

Revisión

Tipo: DWORD

Se puede usar para ayudar a identificar un conjunto de chip determinado. Consulte a este miembro para identificar el nivel de revisión del conjunto de chip. El valor puede ser cero si se desconoce.

DeviceIdentifier

Tipo: GUID

Se puede consultar para comprobar los cambios en el controlador y el conjunto de chip. Este GUID es un identificador único para el par de controladores y conjuntos de chip. Consulte a este miembro para realizar un seguimiento de los cambios realizados en el controlador y el conjunto de chip para generar un nuevo perfil para el subsistema de gráficos. DeviceIdentifier también se puede usar para identificar controladores problemáticos concretos.

WHQLLevel

Tipo: DWORD

Se usa para determinar el nivel de validación de Windows Hardware Quality Labs (WHQL) para este par de controladores y dispositivos. DWORD es una estructura de fecha empaquetada que define la fecha de la versión de la prueba WHQL más reciente que ha superado el controlador. Es legal realizar < y > realizar operaciones en este valor. A continuación se muestra el formato de fecha.

Bits Descripción
31-16 El año, un número decimal de 1999 hacia arriba.
15-8 El mes, un número decimal de 1 a 12.
7-0 El día, un número decimal de 1 a 31.

 

También se usan los valores siguientes.

Value Descripción
0 No certificado.
1 WHQL validado, pero no hay información de fecha disponible.

 

Diferencias entre Direct3D 9 y Direct3D 9Ex:

Para Direct3D9Ex que se ejecuta en Windows Vista, Windows Server 2008, Windows 7 y Windows Server 2008 R2 (o más sistema operativo actual), IDirect3D9::GetAdapterIdentifier devuelve 1 para el nivel WHQL sin comprobar el estado del controlador.

Comentarios

En el ejemplo de pseudocódigo siguiente se muestra el formato de versión codificado en los miembros DriverVersion, DriverVersionLowPart y DriverVersionHighPart.

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

Consulte el SDK de plataforma para obtener más información sobre la macro HIWORD, la macro LOWORD y la estructura LARGE_INTEGER.

MAX_DEVICE_IDENTIFIER_STRING es una constante con la siguiente definición.

#define MAX_DEVICE_IDENTIFIER_STRING        512

Los miembros VendorId, DeviceId, SubSysId y Revision se pueden usar conjuntamente para identificar determinados conjuntos de chip. Sin embargo, use estos miembros con precaución.

Requisitos

Requisito Value
Encabezado
D3D9Types.h

Consulte también

Estructuras de Direct3D