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

Подпрограмма 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

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

[in] SetIndex

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

[in] CurrentPerf

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

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

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

Замечания

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

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

Требования

См. также

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

PO_FX_COMPONENT_PERF_INFO

PO_FX_COMPONENT_PERF_SET

PoFxRegisterComponentPerfStates