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

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

  • Статья

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

Синтаксис

NTSTATUS D3DKMTEnumAdapters2(
  const D3DKMT_ENUMADAPTERS2 *unnamedParam1
);

Параметры

unnamedParam1

[вход, выход] Указатель на D3DKMT_ENUMADAPTERS2 структуру, в которой предоставляется информация об адаптерах в системе. См. заметки.

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

D3DKMTEnumAdapters2 возвращает STATUS_SUCCESS при успешном выполнении или ошибке, например одной из следующих.

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

Комментарии

Во входных данных NumAdapters указывает, сколько адаптеров может быть возвращено в пустом массиве, на который указывает pAdapters . Если D3DKMT_ENUMADAPTERS2 возвращает STATUS_SUCCESS:

  • Если pAdapters не равно NULL, NumAdapters будет содержать количество адаптеров, возвращенных в массиве pAdapters .
  • Если pAdapters имеет значение NULL, NumAdapters будет содержать максимальное поддерживаемое число адаптеров.

Если D3DKMT_ENUMADAPTERS2 возвращает ошибку, NumAdapters не определен.

D3DKMTEnumAdapters2 обычно вызывается дважды:

  • Для первого вызова присвойте pAdapters значение NULL. D3DKMTEnumAdapters2 записывает максимальное поддерживаемое число адаптеров в NumAdapters.

  • Для второго вызова задайте для NumAdapters значение, возвращенное в первом вызове, и задайте pAdapters , чтобы указать массив NumAdaptersD3DKMT_ENUMADAPTERS2 структур. D3DKMTEnumAdapters2 заполнит массив и передаст количество структур массива (адаптеров), которые он заполнил.

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

Требования

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

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

D3DKMT_ENUMADAPTERS2

PFND3DKMT_ENUMADAPTERS2

D3DKMTCloseAdapter