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


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

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

Синтаксис

PFND3DKMT_ENUMADAPTERS2 Pfnd3dkmtEnumadapters2;

NTSTATUS Pfnd3dkmtEnumadapters2(
  const D3DKMT_ENUMADAPTERS2 *unnamedParam1
)
{...}

Параметры

unnamedParam1

_Inout_D3DKMT_ENUMADAPTERS2 * Arg1

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

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

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

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

Комментарии

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

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

Требования

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

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