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

  • Статья

Функция pfnAcquireNextDescriptorInfo возвращает следующий дескриптор в наборе дескрипторов монитора с учетом текущего дескриптора.

Синтаксис

DXGKDDI_MONITORDESCRIPTORSET_ACQUIRENEXTDESCRIPTORINFO DxgkddiMonitordescriptorsetAcquirenextdescriptorinfo;

NTSTATUS DxgkddiMonitordescriptorsetAcquirenextdescriptorinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORDESCRIPTORSET hMonitorDescriptorSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_DESCRIPTOR_CONST pMonitorDescriptorInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_DESCRIPTOR ppNextMonitorDescriptorInfo
)
{...}

Параметры

[in] hMonitorDescriptorSet

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

[in] pMonitorDescriptorInfo

Указатель на структуру D3DKMDT_MONITOR_DESCRIPTOR , которая является текущим дескриптором. Драйвер мини-порта дисплея ранее получил этот указатель, вызвав pfnAcquireFirstDescriptorInfo или pfnAcquireNextDescriptorInfo.

[out] ppNextMonitorDescriptorInfo

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

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

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

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

Комментарии

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

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

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Целевая платформа Персональный компьютер
Верхняя часть d3dkmddi.h (включая D3dkmddi.h)
IRQL PASSIVE_LEVEL