Edit

PEP_COMPONENT_PLATFORM_CONSTRAINTS structure (pep_x.h)

  • Article

The PEP_COMPONENT_PLATFORM_CONSTRAINTS structure describes the lowest-powered Fx state of that a component can be in when the platform is in a particular idle state.

Syntax

typedef struct _PEP_COMPONENT_PLATFORM_CONSTRAINTS {
  [in] PEPHANDLE DeviceHandle;
  [in] ULONG     Component;
  [in] PULONG    MinimumFStates;
  [in] ULONG     PlatformStateCount;
} PEP_COMPONENT_PLATFORM_CONSTRAINTS, *PPEP_COMPONENT_PLATFORM_CONSTRAINTS;

Members

[in] DeviceHandle

A PEPHANDLE value that identifies the device. The platform extension plug-in (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] MinimumFStates

A pointer to an output buffer. The PEP writes a ULONG array to this buffer that specifies the lowest-powered Fx state that the component can be in for each platform idle state. An element with a value of 0 indicates F0, a value of 1 indicates F1, and so on. If the platform supports M idle states, array elements 0 to M–1 specify the Fx states corresponding to platform idle states 0 to M–1.

[in] PlatformStateCount

The number of elements in the MinimumFStates array. The array contains one element for each platform idle state. The Windows power management framework (PoFx) previously sent a PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES notification to the PEP to determine the number of supported platform idle states.

Remarks

This structure is used by the PEP_DPM_COMPONENT_IDLE_CONSTRAINTS notification. All four members of the structure contain input values that PoFx supplies when this notification is sent. PoFx allocates the buffer pointed to by the MinimumFStates member, and the PEP writes to this buffer in response to the notification.

Requirements

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

See also

PEP_DEVICE_REGISTER_V2

PEP_DPM_COMPONENT_IDLE_CONSTRAINTS

PEP_DPM_REGISTER_DEVICE

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES