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

Статья
02/07/2025

Подпрограмма обратного вызова компонента 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

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

[in] Succeeded

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

[in] RequestContext

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

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

Никакой

Замечания

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

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

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

Требования

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

См. также

PoFxIssueComponentPerfStateChange

PoFxIssueComponentPerfStateChangeMultiple

PoFxRegisterDevice

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