Функция PoFxSetComponentWake (wdm.h)

  • Статья

Подпрограмма PoFxSetComponentWake указывает, активирует ли драйвер указанный компонент для пробуждения всякий раз, когда компонент входит в состояние простоя.

Синтаксис

void PoFxSetComponentWake(
  [in] POHANDLE Handle,
  [in] ULONG    Component,
  [in] BOOLEAN  WakeHint
);

Параметры

[in] Handle

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

[in] Component

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

[in] WakeHint

Указывает, активирует ли драйвер компонент для пробуждения всякий раз, когда компонент входит в состояние простоя. Если значение РАВНО TRUE, драйвер активит компонент для пробуждения. Если значение РАВНО FALSE, драйвер не вооружает компонент для пробуждения.

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

None

Remarks

Прежде чем компонент перейдет в маломощное состояние Fx, драйвер может включить компонент для автоматического пробуждения в ответ на входной сигнал из внешнего источника (например, если пользователь нажимает кнопку). Параметр WakeHint сообщает PoFx, должен ли драйвер включить компонент для пробуждения. Если компонент вооружен для пробуждения, PoFx не переключит компонент в маломощное состояние Fx, из которого компонент не может проснуться.

При регистрации устройства с помощью PoFx сведения о регистрации каждого компонента устройства содержатся в отдельной структуре PO_FX_COMPONENT . Элемент DeepestWakeableIdleState этой структуры указывает самое глубокое состояние Fx, из которого компонент может проснуться.

Драйвер устройства может вызывать PoFxSetComponentWake каждый раз, когда изменение условий требует изменения значения WakeHint . После каждого вызова новое значение WakeHint остается в силе до тех пор, пока драйвер снова не вызовет PoFxSetComponentWake , чтобы обновить его.

Если компонент находится в состоянии простоя при вызове PoFxSetComponentWake , PoFx может изменить состояние Fx компонента в соответствии с новым значением параметра WakeHint , указанным вызывающим объектом.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 8.
Целевая платформа Универсальное
Верхняя часть wdm.h
Библиотека Ntoskrnl.lib
DLL Ntoskrnl.exe
IRQL <= DISPATCH_LEVEL

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

PO_FX_COMPONENT