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

Статья
08/08/2023

Подпрограмма обратного вызова ComponentCriticalTransitionCallback обрабатывает переход указанного компонента между F0 (полностью включен) и низким уровнем питания Fx .

Синтаксис

PO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK PoFxComponentCriticalTransitionCallback;

void PoFxComponentCriticalTransitionCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Active
)
{...}

Параметры

[in] Context

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

[in] Component

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

[in] Active

Указывает, предназначено ли это уведомление для перехода в состояние питания компонента F0. Если задано значение TRUE, компонент только что завершил переход из маломощного состояния Fx в F0. Если значение FALSE, компонент начинает переход из F0 в маломощное состояние Fx .

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

None

Remarks

Эта подпрограмма обратного вызова реализуется драйвером устройства и вызывается с помощью PoFx. PoFx вызывает эту подпрограмму для уведомления драйвера о переключениях питания компонентов устройства.

Элемент ComponentCriticalTransitionCallbackструктуры PO_FX_CORE_DEVICE является указателем на подпрограмму обратного вызова ComponentCriticalTransitionCallback . Указатель на структуру PO_FX_CORE_DEVICE передается в качестве входного параметра в вызове PoFxRegisterCoreDevice, который регистрирует основное устройство с помощью платформы управления питанием Windows (PoFx).

Для обработки вызовов этой подпрограммы драйвер устройства сохраняет или восстанавливает состояние регистрации или другой аппаратный контекст указанного компонента на устройстве.

Если Активный = TRUE, PoFx вызвал эту подпрограмму после того, как компонент завершил переход из маломощного состояния Fx в F0. В этом вызове подпрограмма восстанавливает ранее сохраненный аппаратный контекст компонента.

Если активен = FALSE, PoFx вызвал эту подпрограмму до того, как компонент начнет отложенный переход из F0 в маломощное состояние Fx . В этом вызове подпрограмма сохраняет аппаратный контекст компонента, чтобы впоследствии можно было восстановить этот контекст.

Дополнительные сведения о состояниях питания компонентов Fx см. в разделе Управление питанием на уровне компонентов.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается начиная с Windows 10.
Целевая платформа	Windows
Header	wdm.h (включая Wudfwdm.h)

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

PO_FX_CORE_DEVICE