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

функция обратного вызова 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

См. также