Share via

структура D3DADAPTER_IDENTIFIER9

  • Статья

Содержит сведения, идентифицирующие адаптер.

Синтаксис

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;

Члены

Драйвер

Тип: char

Используется для презентации пользователю. Это не следует использовать для идентификации конкретных драйверов, так как много разных строк может быть связано с тем же устройством и драйвером от разных поставщиков.

Описание

Тип: char

Используется для презентации пользователю.

DeviceName

Тип: char

Имя устройства для GDI.

DriverVersion

Тип: LARGE_INTEGER

Определите версию драйвера Direct3D. В 64-разрядном целочисленном значении со знаком можно выполнять сравнение меньше и больше. Однако соблюдайте осторожность, если вы используете этот элемент для выявления проблемных факторов. Вместо этого следует использовать DeviceIdentifier. См. заметки.

DriverVersionLowPart

Тип: DWORD

Определите версию драйвера Direct3D. Это законное < сравнение и > для 64-разрядного целочисленного значения со знаком. Однако соблюдайте осторожность, если вы используете этот элемент для выявления проблемных факторов. Вместо этого следует использовать DeviceIdentifier. См. заметки.

DriverVersionHighPart

Тип: DWORD

Определите версию драйвера Direct3D. Это законное < сравнение и > для 64-разрядного целочисленного значения со знаком. Однако соблюдайте осторожность, если вы используете этот элемент для выявления проблемных факторов. Вместо этого следует использовать DeviceIdentifier. См. заметки.

VendorId

Тип: DWORD

Может использоваться для идентификации определенного набора микросхем. Запросите этот элемент, чтобы определить изготовителя. Значение может быть равным нулю, если неизвестно.

DeviceId

Тип: DWORD

Может использоваться для идентификации определенного набора микросхем. Запросите этот элемент, чтобы определить тип набора микросхем. Значение может быть равным нулю, если неизвестно.

SubSysId

Тип: DWORD

Может использоваться для идентификации определенного набора микросхем. Запросите этот элемент, чтобы определить подсистему, как правило, определенную плату. Значение может быть равным нулю, если неизвестно.

Редакция

Тип: DWORD

Может использоваться для идентификации определенного набора микросхем. Запросите этот элемент, чтобы определить уровень редакции набора микросхем. Значение может быть равным нулю, если неизвестно.

DeviceIdentifier

Тип: GUID

Можно запрашивать для проверка изменений в драйвере и наборе микросхем. Этот GUID является уникальным идентификатором для пары драйверов и наборов микросхем. Запросите этот элемент для отслеживания изменений в драйвере и наборе микросхем, чтобы создать новый профиль для графической подсистемы. DeviceIdentifier также можно использовать для выявления конкретных проблемных драйверов.

WHQLLevel

Тип: DWORD

Используется для определения уровня проверки Windows Hardware Quality Labs (WHQL) для этой пары драйверов и устройств. DWORD — это упакованная структура даты, определяющая дату выпуска последнего теста WHQL, пройденного драйвером. Это законное выполнение < операций и > с этим значением. Ниже показан формат даты.

Bits Описание
31-16 Год, десятичное число от 1999 года до.
15-8 Месяц , десятичное число от 1 до 12.
7-0 День, десятичное число от 1 до 31.

 

Также используются следующие значения.

Значение Описание
0 Не сертифицировано.
1 WHQL проверен, но нет сведений о дате.

 

Различия между Direct3D 9 и Direct3D 9Ex:

Для Direct3D9Ex, работающего в Windows Vista, Windows Server 2008, Windows 7 и Windows Server 2008 R2 (или более текущей операционной системе), IDirect3D9::GetAdapterIdentifier возвращает 1 для уровня WHQL без проверки состояния драйвера.

Комментарии

В следующем примере псевдокода показан формат версии, закодированный в членах DriverVersion, DriverVersionLowPart и DriverVersionHighPart.

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

Дополнительные сведения о макросе HIWORD, макросе LOWORD и структуре LARGE_INTEGER см. в пакете SDK для платформы.

MAX_DEVICE_IDENTIFIER_STRING является константой со следующим определением.

#define MAX_DEVICE_IDENTIFIER_STRING        512

Члены VendorId, DeviceId, SubSysId и Revision можно использовать в тандеме для идентификации определенных наборов микросхем. Однако используйте эти элементы с осторожностью.

Требования

Требование Значение
Заголовок
D3D9Types.h

См. также раздел

Структуры Direct3D