структура PO_FX_CORE_DEVICE (pep_x.h)

  • Статья

Структура PO_FX_CORE_DEVICE содержит сведения об атрибутах состояния питания компонентов в основном системном ресурсе и предоставляет программный интерфейс для управления этими компонентами.

Синтаксис

typedef struct _PO_FX_CORE_DEVICE {
  ULONG                                         Version;
  ULONG                                         ComponentCount;
  PPO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK    ComponentActiveConditionCallback;
  PPO_FX_COMPONENT_IDLE_CONDITION_CALLBACK      ComponentIdleConditionCallback;
  PPO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK ComponentCriticalTransitionCallback;
  PPO_FX_COMPONENT_IDLE_STATE_CALLBACK          ComponentIdleStateCallback;
  PVOID                                         DeviceContext;
  PO_FX_COMPONENT                               Components[ANYSIZE_ARRAY];
} PO_FX_CORE_DEVICE, *PPO_FX_CORE_DEVICE;

Члены

Version

Номер версии этой структуры.

ComponentCount

Количество элементов в массиве Components в конце этой структуры. Это число включает все элементы массива и первый элемент, который является членом данной структуры, и все дополнительные элементы, следующие за концом этой структуры.

ComponentActiveConditionCallback

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

ComponentIdleConditionCallback

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

ComponentCriticalTransitionCallback

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

ComponentIdleStateCallback

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

DeviceContext

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

Components[ANYSIZE_ARRAY]

Первый элемент в массиве PO_FX_COMPONENT структур. Каждый элемент в массиве описывает атрибуты питания компонента на устройстве. Если массив содержит несколько элементов, дополнительные элементы сразу же следуют за концом структуры PO_FX_CORE_DEVICE . Число элементов в массиве указывается в элементе ComponentCount структуры PO_FX_CORE_DEVICE .

Комментарии

Эта структура используется подпрограммой PoFxRegisterCoreDevice .

Основной системный ресурс — это аппаратное устройство, например таймер или контроллер прерываний, которое управляется уровнем аппаратной абстракции Windows (HAL).

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

Требования

Требование Значение
Минимальная версия клиента Поддерживается начиная с Windows 10.
Верхняя часть pep_x.h (включая Pep_x.h)

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

ComponentActiveConditionCallback

ComponentCriticalTransitionCallback

ComponentIdleConditionCallback

ComponentIdleStateCallback

PO_FX_COMPONENT

PoFxRegisterCoreDevice