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

  • Статья

Функция 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интерфейса Monitor.

[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 (включая D3dkmddi.h)
IRQL PASSIVE_LEVEL