функция обратного вызова PFND3DKMT_ENUMADAPTERS3 (d3dkmthk.h)

Статья
08/07/2023

Функция обратного вызова PFND3DKMT_ENUMADAPTERS3 перечисляет графические и видеоадаптеры в системе.

Синтаксис

PFND3DKMT_ENUMADAPTERS3 Pfnd3dkmtEnumadapters3;

NTSTATUS Pfnd3dkmtEnumadapters3(
  [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, адаптеры по-прежнему перечисляются, но адаптеров меньше, чем PFND3DKMT_ENUMADAPTERS2 перечисления. Адаптеры ComputeOnly не используются в перечислении по умолчанию, чтобы избежать нарушения работы приложений. Адаптеры DisplayOnly также не входят в перечисление по умолчанию.