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

Статья
02/06/2025

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

Синтаксис

DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIREFIRSTFREQUENCYRANGEINFO DxgkddiMonitorfrequencyrangesetAcquirefirstfrequencyrangeinfo;

NTSTATUS DxgkddiMonitorfrequencyrangesetAcquirefirstfrequencyrangeinfo(
  [in]  IN_CONST_D3DKMDT_HMONITORFREQUENCYRANGESET hMonitorFrequencyRangeSet,
  [out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_FREQUENCY_RANGE ppFirstMonitorFrequencyRangeInfo
)
{...}

Параметры

[in] hMonitorFrequencyRangeSet

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

[out] ppFirstMonitorFrequencyRangeInfo

Указатель на переменную, которая получает указатель на структуру D3DKMDT_MONITOR_FREQUENCY_RANGE.

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

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

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

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

Замечания

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
целевая платформа	Настольный
заголовка	d3dkmddi.h (include D3dkmddi.h)
IRQL	PASSIVE_LEVEL

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