POFXCALLBACKCRITICALRESOURCE callback function (pep_x.h)

Article
02/22/2024

The TransitionCriticalResource routine changes the active/inactive state of a core system component.

Syntax

POFXCALLBACKCRITICALRESOURCE Pofxcallbackcriticalresource;

void Pofxcallbackcriticalresource(
  [in] POHANDLE DeviceHandle,
  [in] ULONG Component,
  [in] BOOLEAN Active
)
{...}

Parameters

[in] DeviceHandle

A POHANDLE value that represents the registration of the device with PoFx. The PEP previously received this handle from PoFx during the PEP_DPM_REGISTER_DEVICE notification that informed the PEP that the device's driver stack registered the device with PoFx.

[in] Component

[in] 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 to transition the device from inactive to active, or vice versa. Set to TRUE to transition the device from inactive to active, or to FALSE to transition the device from active to inactive.

Return value

None

Remarks

This routine is implemented by the power management framework (PoFx) and is called by the platform extension plug-in (PEP). The TransitionCriticalResource member of the PEP_KERNEL_INFORMATION_STRUCT_V3 structure is a pointer to an TransitionCriticalResource routine.

A PEP can call this routine at IRQL <= HIGH_LEVEL.

Requirements

Requirement	Value
Minimum supported client	Supported starting with Windows 10.
Target Platform	Windows
Header	pep_x.h (include Pep_x.h)
IRQL	<= HIGH_LEVEL