функция обратного вызова 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 |