Метод IDirect3D9::GetAdapterIdentifier (d3d9helper.h)

Статья
08/23/2023

Описывает физические видеоадаптеры, присутствующие в системе при создании экземпляра интерфейса IDirect3D9 .

Синтаксис

HRESULT GetAdapterIdentifier(
  [in]  UINT                   Adapter,
  [in]  DWORD                  Flags,
  [out] D3DADAPTER_IDENTIFIER9 *pIdentifier
);

Параметры

[in] Adapter

Тип: UINT

Порядковый номер, обозначающий видеоадаптер. D3DADAPTER_DEFAULT всегда является основным видеоадаптером. Минимальное значение для этого параметра равно 0, а максимальное значение этого параметра на один меньше значения, возвращаемого getAdapterCount.

[in] Flags

Тип: DWORD

Флаги задает элемент WHQLLevelD3DADAPTER_IDENTIFIER9. Для флагов можно задать значение 0 или D3DENUM_WHQL_LEVEL. Если указан D3DENUM_WHQL_LEVEL, этот вызов может подключиться к Интернету, чтобы скачать новые сертификаты Microsoft Windows Hardware Quality Labs (WHQL).

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

D3DENUM_WHQL_LEVEL является устаревшей для Direct3D9Ex, работающей в Windows Vista, Windows Server 2008, Windows 7 и Windows Server 2008 R2 (или более текущей операционной системе). Любая из этих операционных систем возвращает 1 в элементе WHQLLevelD3DADAPTER_IDENTIFIER9 без проверки состояния драйвера.

[out] pIdentifier

Тип: D3DADAPTER_IDENTIFIER9*

Указатель на структуру D3DADAPTER_IDENTIFIER9 , заполняемую сведениями, описывающими этот адаптер. Если значение Adapter больше или равно количеству адаптеров в системе, эта структура будет обнуляться.

Возвращаемое значение

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет D3D_OK. D3DERR_INVALIDCALL возвращается, если адаптер выходит за пределы диапазона, если flags содержит нераспознанные параметры или если pIdentifier имеет значение NULL или указывает на незаписываемую память.

Требования

Требование	Значение
Целевая платформа	Windows
Header	d3d9helper.h (включая D3D9.h)
Библиотека	D3D9.lib

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

GetAdapterCount

IDirect3D9

Поделиться через