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

Статья
02/06/2025

Функция обратного вызова 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 также остаются без перечисления по умолчанию.