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

  • Статья

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

Синтаксис

DXGKDDI_MONITOR_GETMONITORFREQUENCYRANGESET DxgkddiMonitorGetmonitorfrequencyrangeset;

NTSTATUS DxgkddiMonitorGetmonitorfrequencyrangeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PD3DKMDT_HMONITORFREQUENCYRANGESET phMonitorFrequencyRangeSet,
  [out] DEREF_OUT_CONST_PPDXGK_MONITORFREQUENCYRANGESET_INTERFACE ppMonitorFrequencyRangeSetInterface
)
{...}

Параметры

[in] hAdapter

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

[in] VideoPresentTargetId

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

[out] phMonitorFrequencyRangeSet

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

[out] ppMonitorFrequencyRangeSetInterface

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

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

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

Код возврата Описание
STATUS_SUCCESS Функция выполнена успешно.
STATUS_INVALID_PARAMETER Указан недопустимый параметр.
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 структур, каждая из которых содержит идентификатор.

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

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

Требования

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

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

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality