PEP_DEVICE_POWER_STATE structure (pep_x.h)

The PEP_DEVICE_POWER_STATE structure indicates the status of a transition to a new Dx (device power) state.

Syntax

typedef struct _PEP_DEVICE_POWER_STATE {
  [in] PEPHANDLE          DeviceHandle;
  [in] DEVICE_POWER_STATE PowerState;
  [in] BOOLEAN            Complete;
  [in] BOOLEAN            SystemTransition;
} PEP_DEVICE_POWER_STATE, *PPEP_DEVICE_POWER_STATE;

Members

[in] DeviceHandle

The PEPHANDLE value that identifies this device. The PEP previously created this handle in response to a PEP_DPM_REGISTER_DEVICE notification from the Windows power management framework (PoFx).

[in] PowerState

A DEVICE_POWER_STATE enumeration value that specifies the new device power state.

[in] Complete

Whether the transition to the new device power state has just been initiated or has just completed. If TRUE, the transition to the target device power state has completed. If FALSE, the power policy owner (PPO) has initiated the transition by calling the PoRequestPowerIrp routine, but the Windows power manager has not yet issued the Dx IRP (an IRP_MN_SET_POWER request of type DevicePowerState) to the device's driver stack.

[in] SystemTransition

Always set to FALSE.

Remarks

This structure is used by the PEP_DPM_DEVICE_POWER_STATE notification. All four members of the structure contain input values that are supplied by PoFx. The PEP does not write to this structure.

Requirements

Requirement Value
Minimum supported client Supported starting with Windows 10.
Header pep_x.h (include Pep_x.h)

See also

DEVICE_POWER_STATE

IRP_MN_SET_POWER

PEP_DPM_DEVICE_POWER_STATE

PEP_DPM_REGISTER_DEVICE

PoRequestPowerIrp