PEP_NOTIFY_COMPONENT_IDLE_STATE structure (pepfx.h)

The PEP_NOTIFY_COMPONENT_IDLE_STATE structure contains status information about a component's pending transition to a new Fx power state.

Syntax

typedef struct _PEP_NOTIFY_COMPONENT_IDLE_STATE {
  [in]  PEPHANDLE DeviceHandle;
  [in]  ULONG     Component;
  [in]  ULONG     IdleState;
  [in]  BOOLEAN   DriverNotified;
  [out] BOOLEAN   Completed;
} PEP_NOTIFY_COMPONENT_IDLE_STATE, *PPEP_NOTIFY_COMPONENT_IDLE_STATE;

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] IdleState

The new Fx power state that the component will transition to. If this parameter is zero, the new state is F0; if this parameter is one, the new state is F1; and so on.

[in] DriverNotified

Whether the driver for the device has already been notified of the pending transition to the new Fx state. If TRUE, the power management framework (PoFx) already notified the driver by calling the driver's ComponentIdleStateCallback callback routine. If FALSE, PoFx has not yet notified the driver.

[out] Completed

Whether the PEP has completed all necessary preparations for the specified component to enter the new Fx state. Set to TRUE to indicate that the PEP has completed all necessary preparations, or to FALSE to indicate that is has not.

If FALSE, the PEP must complete the necessary preparations at a later time and then inform PoFx when the preparations have been completed. To do so, the PEP calls the RequestWorker routine to request a work item, and then responds to the ensuing PEP_DPM_WORK notification by submitting a work request of type PepWorkCompleteIdleState to inform PoFx that the preparations are complete.

Remarks

This structure is used by the PEP_DPM_NOTIFY_COMPONENT_IDLE_STATE notification. The first four members of this structure contain input values that are supplied by PoFx. The Completed member contains an output value that the PEP writes to the structure in response to this notification.

Requirements

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

See also

PEP_DEVICE_REGISTER_V2

PEP_DPM_NOTIFY_COMPONENT_IDLE_STATE

PEP_DPM_REGISTER_DEVICE

PEP_DPM_WORK

RequestWorker