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

  • Статья

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

Синтаксис

DXGKDDI_MONITORDESCRIPTORSET_ACQUIREFIRSTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirefirstdescriptorinfo;

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

Параметры

[in] hMonitorDescriptorSet

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

[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 (включая D3dkmddi.h)
IRQL PASSIVE_LEVEL