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

Статья
08/08/2023

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

Синтаксис

PO_FX_COMPONENT_PERF_STATE_CALLBACK PoFxComponentPerfStateCallback;

void PoFxComponentPerfStateCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Succeeded,
  [in] PVOID RequestContext
)
{...}

Параметры

[in] Context

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

[in] Component

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

[in] Succeeded

Если задано значение TRUE, подключаемый модуль расширения платформы (PEP) успешно изменил состояние производительности. Если значение FALSE, peP не удалось изменить состояние производительности. Дополнительные сведения см. в разделе «Примечания».

[in] RequestContext

Указатель на необязательный контекст драйвера или устройства, заданный параметром Contextподпрограммы PoFxIssueComponentPerfStateChange или PoFxIssueComponentPerfStateChangeMultiple .

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

None

Remarks

Когда драйвер устройства запрашивает изменение состояния производительности путем вызова подпрограммы PoFxIssueComponentPerfStateChange или PoFxIssueComponentPerfStateChangeMultiple , PoFx вызывает подпрограмму ComponentPerfStateCallback , чтобы уведомить драйвер о завершении запроса.

Чтобы указать подпрограмму ComponentPerfStateCallback , используйте параметр ComponentPerfStateCallback подпрограммы PoFxRegisterComponentPerfStates , когда драйвер регистрируется для управления состоянием производительности с помощью PoFx. Подпрограмма ComponentPerfStateCallback может быть одинаковой для всех компонентов и всех устройств.

Если значение Выполнено имеет значение TRUE, драйвер должен выполнить все необходимые действия, чтобы изменить состояние производительности на оборудовании. Если значение Succeeded имеет значение FALSE, драйвер может ничего не делать или повторить запрос с тем же состоянием производительности или альтернативным состоянием производительности.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается начиная с Windows 10.
Целевая платформа	Персональный компьютер
Верхняя часть	wdm.h
IRQL	Вызывается по адресу IRQL <= DISPATCH_LEVEL.

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

PoFxIssueComponentPerfStateChange

PoFxIssueComponentPerfStateChangeMultiple

PoFxRegisterDevice

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