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

Статья
02/06/2025

Функция pfnAcquireFirstDescriptorInfo возвращает первый дескриптор в объекте набора дескрипторов монитора.

Синтаксис

DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo;

NTSTATUS DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORDESCRIPTORSET hMonitorDescriptorSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_DESCRIPTOR ppFirstMonitorDescriptorInfo
)
{...}

Параметры

[in] hMonitorDescriptorSet

Дескриптор набора дескрипторов монитора. Драйвер минипорта отображения ранее получил этот дескриптор, вызвав функцию pfnGetMonitorDescriptorSet интерфейса монитора .

[out] ppFirstMonitorDescriptorInfo

Указатель на переменную, которая получает указатель на структуру D3DKMDT_MONITOR_DESCRIPTOR. Структура является первым дескриптором в наборе.

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

Функция pfnAcquireFirstDescriptorInfo возвращает одно из следующих значений.

Возвращаемый код	Описание
STATUS_SUCCESS	Функция успешно вернула первый дескриптор в наборе.
STATUS_GRAPHICS_DATASET_IS_EMPTY	Функция завершилась успешно, но в наборе не было дескрипторов.
STATUS_INVALID_PARAMETER	Указан недопустимый параметр.
STATUS_GRAPHICS_INVALID_MONITOR_DESCRIPTORSET	Дескриптор, предоставленный в hMonitorDescriptorSet, был недопустим.

Замечания

Завершив использование структуры D3DKMDT_MONITOR_DESCRIPTOR, необходимо освободить структуру, вызвав pfnReleaseDescriptorInfo.

Вы можете получить все дескрипторы в дескрипторе монитора, вызвав pfnAcquireFirstDescriptorInfo, а затем выполнив последовательность вызовов pfnAcquireNextDescriptorInfo.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
целевая платформа	Настольный
заголовка	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

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