estructura de D3DADAPTER_IDENTIFIER9
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 |
|
Consulte también