Функция PoFxQueryCurrentComponentPerfState (wdm.h)

Статья
08/08/2023

Подпрограмма PoFxQueryCurrentComponentPerfState извлекает активное состояние производительности в наборе состояний производительности компонента.

Синтаксис

NTSTATUS PoFxQueryCurrentComponentPerfState(
  [in] POHANDLE   Handle,
  [in] ULONG      Flags,
  [in] ULONG      Component,
  [in] ULONG      SetIndex,
  [in] PULONGLONG CurrentPerf
);

Параметры

[in] Handle

Дескриптор, представляющий регистрацию устройства с помощью платформы управления питанием (PoFx). Драйвер устройства ранее получил этот дескриптор из подпрограммы PoFxRegisterDevice .

[in] Flags

Задайте значение 0. В настоящее время для этой подпрограммы не определены флаги.

[in] Component

Индекс, определяющий компонент, состояние производительности которого извлекается. Этот параметр является индексом массива Components в структуре PO_FX_DEVICE , используемой драйвером устройства для регистрации устройства с помощью PoFx. Если массив Components содержит N элементов, индексы компонентов варьируются от 0 до N–1.

[in] SetIndex

Индекс, определяющий набор состояний производительности, производительность которого запрашивается. Этот параметр является индексом массива PerfStateSets в структуре PO_FX_COMPONENT_PERF_INFO , используемой драйвером устройства для регистрации состояний производительности компонента в PoFx. Если массив PerfStateSets содержит N элементов, индексы набора состояний производительности варьируются от 0 до N–1.

[in] CurrentPerf

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

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

PoFxQueryCurrentComponentPerfState возвращает STATUS_SUCCESS , если запрошенная операция выполнена успешно. Возможные возвращаемые значения ошибок включают следующие коды состояния.

Код возврата	Описание
STATUS_INVALID_PARAMETER	Вызывающий объект предоставил недопустимый индекс для набора состояний компонента или компонента.

Драйвер может вызвать подпрограмму PoFxQueryCurrentComponentPerfState , чтобы получить текущее состояние производительности заданного набора состояний производительности для компонента. Если вызов выполняется успешно, параметр CurrentPerf перезаписывается указателем на значение, указывающее текущее состояние производительности набора. Это значение может быть одним из следующих значений в зависимости от содержимого структуры PO_FX_COMPONENT_PERF_SET , переданной драйвером в подпрограмму PoFxRegisterComponentPerfStates :

Для набора состояний производительности, представляющего непрерывное распределение состояний производительности, это значение между элементами минимального и максимального значений структуры PO_FX_COMPONENT_PERF_SET .
Для набора состояний производительности, представляющего дискретное количество состояний производительности, это значение является индексом в элементе Statesструктуры PO_FX_COMPONENT_PERF_SET .

Этот вызов всегда выполняется синхронно.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 10.
Целевая платформа	Универсальное
Верхняя часть	wdm.h
Библиотека	Ntoskrnl.lib
DLL	Ntoskrnl.exe
IRQL	<= DISPATCH_LEVEL

См. также раздел

Управление состоянием производительности устройства

PO_FX_COMPONENT_PERF_INFO

PO_FX_COMPONENT_PERF_SET

PoFxRegisterComponentPerfStates

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