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

  • Статья

Функция pfnGetMonitorDescriptorSet возвращает дескриптор для объекта набора дескрипторов монитора, связанного с указанным монитором.

Синтаксис

DXGKDDI_MONITOR_GETMONITORDESCRIPTORSET DxgkddiMonitorGetmonitordescriptorset;

NTSTATUS DxgkddiMonitorGetmonitordescriptorset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORDESCRIPTORSET phMonitorDescriptorSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORDESCRIPTORSET_INTERFACE ppMonitorDescriptorSetInterface
)
{...}

Параметры

[in] hAdapter

Дескриптор, идентифицирующий видеоадаптер. Подсистема ядра графики Microsoft DirectX ранее предоставляла этот дескриптор драйверу miniport дисплея в параметре DxgkInterface функции DxgkDdiStartDevice .

[in] VideoPresentTargetId

Целое число, идентифицирующее одну из целевых объектов видео на видеоадаптере. Возвращенный объект набора дескрипторов монитора содержит дескрипторы для монитора, подключенного к этому целевому объекту представления видео.

[out] phMonitorDescriptorSet

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

[out] ppMonitorDescriptorSetInterface

Указатель на переменную, получающую указатель на структуру DXGK_MONITORDESCRIPTORSET_INTERFACE . Структура содержит указатели на функции, которые драйвер мини-порта дисплея может вызывать для проверки и изменения объекта набора дескрипторов монитора.

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

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

Код возврата Описание
STATUS_SUCCESS Функция выполнена успешно.
STATUS_INVALID_PARAMETER Указан недопустимый параметр.
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER Дескриптор, предоставленный в hAdapter, был недопустимым.
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET Недопустимый идентификатор, указанный в VideoPresentTargetId.
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED Нет монитора, подключенного к целевому объекту видеоприсутствий, определенному с помощью VideoPresentTargetId.

Комментарии

Целевые идентификаторы VidPN назначаются драйвером мини-порта дисплея. Функция DxgkDdiQueryChildRelations , реализованная драйвером мини-порта дисплея, возвращает массив DXGK_CHILD_DESCRIPTOR структур, каждая из которых содержит идентификатор.

Не нужно освобождать дескриптор, возвращенный в phMonitorDescriptorSet.

Эта функция также доступна в интерфейсе DXGK_MONITOR_INTERFACE_V2 начиная с Windows 7.

Требования

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

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

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality