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


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

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

Синтаксис

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

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

[in] Active

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

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

Никакой

Замечания

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

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

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

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

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

Дополнительные сведения о состояниях питания компонентаX F см. в Component-Levelpower Management.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Поддерживается начиная с Windows 10.
целевая платформа Виндоус
заголовка wdm.h (include Wudfwdm.h)

См. также

PO_FX_CORE_DEVICE