PEP_COMPONENT_ACTIVE structure (pep_x.h)

The PEP_COMPONENT_ACTIVE structure identifies a component that is making a transition between the idle condition and the active condition.

Syntax

typedef struct _PEP_COMPONENT_ACTIVE {
  [in]  PEPHANDLE             DeviceHandle;
  [in]  ULONG                 Component;
  [in]  BOOLEAN               Active;
  [out] PPEP_WORK_INFORMATION WorkInformation;
  [out] BOOLEAN               NeedWork;
} PEP_COMPONENT_ACTIVE, *PPEP_COMPONENT_ACTIVE;

Members

[in] DeviceHandle

A PEPHANDLE value that identifies the device. The PEP supplied this handle in response to a previous PEP_DPM_REGISTER_DEVICE notification.

[in] Component

The index that identifies the component. This member is an index into the Components array in the PEP_DEVICE_REGISTER_V2 structure that the PEP previously supplied in response to the PEP_DPM_REGISTER_DEVICE notification for this device. If the Components array contains N elements, component indexes range from 0 to N–1.

[in] Active

Whether the component is making a transition to the active condition. If TRUE, the component is making a transition from the idle condition to the active condition. If FALSE, the component is making a transition from the active condition to the idle condition.

[out] WorkInformation

A pointer to a PEP_WORK_INFORMATION structure that describes the work that the PEP requests in response to this notification. If NeedWork is TRUE, WorkInformation must point to a valid PEP_WORK_INFORMATION structure. If NeedWork is FALSE, WorkInformation must be NULL.

[out] NeedWork

Whether the PEP has a work request to submit in response to this notification. Set to TRUE if the PEP has work to request, or to FALSE if the PEP has no work to request.

Remarks

This structure is used by the PEP_DPM_COMPONENT_ACTIVE notification. The first three members of the structure contain input values that are supplied by the Windows power management framework (PoFx). The last two members contain output values that the PEP writes to the structure in response to this notification.

Requirements

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

See also

PEP_DEVICE_REGISTER_V2

PEP_DPM_COMPONENT_ACTIVE

PEP_DPM_REGISTER_DEVICE

PEP_WORK_INFORMATION