Функция StorPortPoFxSetPerfState (storport.h)

Статья
08/07/2023

StorPortPoFxSetPerfState задает P-состояние компонента (состояние производительности или perf).

Синтаксис

ULONG StorPortPoFxSetPerfState(
  PVOID         HwDeviceExtension,
  PSTOR_ADDRESS Address,
  ULONG         Component,
  ULONG         Flags,
  ULONG         SetIndex,
  ULONG         State,
  PVOID         Context
);

Параметры

HwDeviceExtension

Указатель на расширение устройства мини-порта.

Address

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

Component

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

Flags

В настоящее время должно быть задано значение NULL.

SetIndex

Индекс ранее зарегистрированного набора производительности.

State

Если набор perf содержит дискретные P-состояния, это должно быть значение индекса. Если набор perf является диапазоном, это должно быть значение в пределах этого диапазона.

Context

Произвольный контекст, который будет передан обратному вызову изменения набора perf.

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

StorPortPoFxSetPerfState возвращает STOR_STATUS_SUCCESS после успешного завершения, если питание среды выполнения было отключено, или код ошибки, например один из следующих:

Код ошибки	Значение
STOR_STATUS_INVALID_PARAMETER	Один из параметров недопустим; Например, значение Address или Flags не равно NULL.
STOR_STATUS_UNSUCCESSFUL	Адаптер не зарегистрирован для обнаружения бездействия.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Верхняя часть	storport.h

Share via