структура PO_FX_DEVICE_V1 (wdm.h)

Статья
08/08/2023

Структура PO_FX_DEVICE описывает атрибуты питания устройства для платформы управления питанием (PoFx).

Синтаксис

typedef struct _PO_FX_DEVICE_V1 {
  ULONG                                      Version;
  ULONG                                      ComponentCount;
  PPO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK ComponentActiveConditionCallback;
  PPO_FX_COMPONENT_IDLE_CONDITION_CALLBACK   ComponentIdleConditionCallback;
  PPO_FX_COMPONENT_IDLE_STATE_CALLBACK       ComponentIdleStateCallback;
  PPO_FX_DEVICE_POWER_REQUIRED_CALLBACK      DevicePowerRequiredCallback;
  PPO_FX_DEVICE_POWER_NOT_REQUIRED_CALLBACK  DevicePowerNotRequiredCallback;
  PPO_FX_POWER_CONTROL_CALLBACK              PowerControlCallback;
  PVOID                                      DeviceContext;
  PO_FX_COMPONENT_V1                         Components[ANYSIZE_ARRAY];
} PO_FX_DEVICE_V1, *PPO_FX_DEVICE_V1;

Члены

Version

Номер версии этой структуры. Если драйвер зарегистрируется для поддержки состояния производительности в PoFx, задайте для этого члена значение PO_FX_VERSION_V2. В противном случае задайте для этого элемента значение PO_FX_VERSION_V1.

ComponentCount

Количество элементов в массиве Components . Кроме того, этот элемент указывает количество компонентов на устройстве.

ComponentActiveConditionCallback

Указатель на подпрограмму обратного вызова ComponentActiveConditionCallback , реализованную драйвером устройства.

ComponentIdleConditionCallback

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

ComponentIdleStateCallback

Указатель на подпрограмму обратного вызова ComponentIdleStateCallback , реализованную драйвером устройства.

DevicePowerRequiredCallback

Указатель на процедуру обратного вызова DevicePowerRequiredCallback , реализованную драйвером устройства.

DevicePowerNotRequiredCallback

Указатель на процедуру обратного вызова DevicePowerNotRequiredCallback , реализованную драйвером устройства.

PowerControlCallback

Указатель на подпрограмму обратного вызова PowerControlCallback , реализованную драйвером устройства.

DeviceContext

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

Components[ANYSIZE_ARRAY]

Этот элемент является первым элементом в массиве из одного или нескольких элементов PO_FX_COMPONENT . Если массив содержит несколько элементов, дополнительные элементы сразу же следуют за PO_FX_DEVICE структурой. Массив содержит по одному элементу для каждого компонента на устройстве. Состоянием питания Fx каждого компонента можно управлять независимо от состояний питания Fx других компонентов на устройстве. Константа ANYSIZE_ARRAY определена как 1 в файле заголовка Ntdef.h.

Чтобы зарегистрировать устройство с помощью PoFx, драйвер вызывает подпрограмму PoFxRegisterDevice и предоставляет в качестве параметра указатель на структуру PO_FX_DEVICE , описывающую устройство.

Каждый элемент в массиве Components описывает атрибуты состояния питания одного компонента на устройстве. Каждый компонент на устройстве идентифицируется по индексу массива Компонентов . Подпрограммы, такие как PoFxActivateComponent и PoFxCompleteIdleCondition , используют индекс массива компонента для идентификации компонента.

Драйвер устройства не требуется для реализации всех шести процедур обратного вызова. Драйвер может задать для указателя функции в структуре PO_FX_DEVICE значение NULL, если драйвер не реализует соответствующую подпрограмму обратного вызова. Однако необходимо реализовать некоторые подпрограммы обратного вызова. В частности, если один или несколько компонентов на устройстве имеют несколько состояний Fx, драйвер должен реализовать подпрограммы ComponentIdleStateCallback, ComponentActiveConditionCallback и ComponentIdleConditionCallback . В противном случае регистрация устройства завершается сбоем, и PoFxRegisterDevice возвращает STATUS_INVALID_PARAMETER.

Требования

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