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

  • Статья

Функция pfnAcquireNextFrequencyRangeInfo возвращает дескриптор следующего диапазона частот в наборе частот монитора с учетом дескриптора текущего диапазона частот.

Синтаксис

DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo;

NTSTATUS DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORFREQUENCYRANGESET hMonitorFrequencyRangeSet,
  [in]  IN_CONST_PD3DKMDT_MONITOR_FREQUENCY_RANGE_CONST pMonitorFrequencyRangeInfo,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_FREQUENCY_RANGE ppNextMonitorFrequencyRangeInfo
)
{...}

Параметры

[in] hMonitorFrequencyRangeSet

Дескриптор объекта набора диапазона частот монитора. Драйвер мини-порта дисплея ранее получил этот дескриптор, вызвав функцию pfnGetMonitorFrequencyRangeSetинтерфейса монитора.

[in] pMonitorFrequencyRangeInfo

Указатель на структуру D3DKMDT_MONITOR_FREQUENCY_RANGE , которая является дескриптором текущего диапазона частот. Драйвер мини-порта дисплея ранее получил этот указатель, вызвав pfnAcquireFirstFrequencyRangeInfo или pfnAcquireNextFrequencyRangeInfo.

[out] ppNextMonitorFrequencyRangeInfo

Указатель на переменную, получающую указатель на структуру D3DKMDT_MONITOR_FREQUENCY_RANGE, которая является дескрипторовом следующего диапазона частоты.

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

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

Код возврата Описание
STATUS_SUCCESS Функция успешно вернула дескриптор следующего диапазона частот.
STATUS_GRAPHICS_DATASET_IS_EMPTY Функция выполнена успешно, но в наборе больше не было дескрипторов диапазона частот.
STATUS_INVALID_PARAMETER Указан недопустимый параметр.
STATUS_INVALID_FREQUENCYRANGE Дескриптор диапазона частот, предоставленный в pMonitorFrequencyRangeInfo, был недопустимым.
STATUS_INVALID_MONITOR_FREQUENCYRANGESET Дескриптор, предоставленный в hMonitorFrequencyRangeSet, был недопустимым.

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

Комментарии

Завершив использование структуры D3DKMDT_MONITOR_FREQUENCY_RANGE, необходимо освободить структуру, вызвав pfnReleaseFrequencyRangeInfo.

Вы можете получить все дескрипторы в заданном диапазоне частот монитора, вызвав pfnAcquireFirstFrequencyRangeInfo и выполнив последовательность вызовов pfnAcquireNextFrequencyRangeInfo.

Требования

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