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

Статья
02/06/2025

Функция 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 (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

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