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

Статья
05/26/2023

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

Синтаксис

DXGKDDI_MONITOR_ACQUIREMONITORSOURCEMODESET DxgkddiMonitorAcquiremonitorsourcemodeset;

NTSTATUS DxgkddiMonitorAcquiremonitorsourcemodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORSOURCEMODESET phMonitorSourceModeSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORSOURCEMODESET_INTERFACE ppMonitorSourceModeSetInterface
)
{...}

Параметры

[in] hAdapter

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

[in] VideoPresentTargetId

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

[out] phMonitorSourceModeSet

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

[out] ppMonitorSourceModeSetInterface

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

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

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

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

Эта функция также может возвращать другие коды ошибок, определенные в Ntstatus.h.

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

Завершив использование дескриптора объекта набора в режиме источника монитора, необходимо освободить дескриптор, вызвав pfnReleaseMonitorSourceModeSet. Объекты набора целевого режима считаются ссылками, поэтому при получении дескриптора несколько раз его необходимо освободить столько же раз.

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

Требования

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

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

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality

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