функция обратного вызова 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 (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

См. также

DXGK_MONITOR_INTERFACE_V2

DxgkDdiEnumVidPnCofuncModality