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

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

  • Статья

Функция 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