Функция D3DKMTEnumAdapters3 (d3dkmthk.h)

Статья
08/07/2023

Предоставляет сведения для перечисления графических и видеоадаптеров в системе.

Синтаксис

NTSTATUS D3DKMTEnumAdapters3(
  [in/out] D3DKMT_ENUMADAPTERS3 *unnamedParam1
);

Параметры

[in/out] unnamedParam1

Структура D3DKMT_ENUMADAPTERS3 . Вызывающий объект передает размер массива и пустое пространство массива. Вызываемый проверяет, что в массиве достаточно места, заполняет массив и передает обратно, сколько массива было использовано.

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

Эта функция возвращает NTSTATUS.

Код возврата	Описание
STATUS_BUFFER_TOO_SMALL	Предоставленный массив слишком мал для получения всех адаптеров.
STATUS_INVALID_PARAMETER	Элемент pEnumAdapters имеет значение NULL или иным образом является недопустимой областью памяти.
STATUS_NO_MEMORY	Память не может быть выделена для выполнения операции.

Если D3DKMT_ENUMADAPTERS3::p Adapters имеет значение NULL, D3DKMT_ENUMADAPTERS3::NumAdapters устанавливается максимальное поддерживаемое число адаптеров. Вызывающие вызовы обычно вызывают метод, сначала для получения максимального поддерживаемого количества адаптеров.

После успешного перечисления адаптеров вызываемого объекта он становится ответственным за явное управление временем существования D3DKMT_HANDLEs адаптера. Эти дескрипторы возвращаются вызываемой через pEnumAdapters и должны быть закрыты с помощью D3DKMTCloseAdapter.

Если установить ни один из флагов D3DKMT_ENUMADAPTERS3::Filter, адаптеры по-прежнему перечисляются, но адаптеров меньше, чем в D3DKMTEnumAdapters2 . Адаптеры ComputeOnly не используются в перечислении по умолчанию, чтобы избежать нарушения работы приложений. Адаптеры DisplayOnly также не входят в перечисление по умолчанию.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 версии 2004
Целевая платформа	Windows
Header	d3dkmthk.h (включая D3dkmthk.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll

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

D3DKMT_ENUMADAPTERS3

D3DKMTCloseAdapter

PFND3DKMT_ENUMADAPTERS3