PEPCALLBACKNOTIFYPPM callback function (pep_x.h)

Article
10/21/2021

An AcceptProcessorNotification event callback routine handles processor power management (PPM) notifications from the Windows power management framework (PoFx).

Syntax

PEPCALLBACKNOTIFYPPM Pepcallbacknotifyppm;

BOOLEAN Pepcallbacknotifyppm(
  [in]                PEPHANDLE Handle,
  [in]                ULONG Notification,
  [in, out, optional] PVOID Data
)
{...}

Parameters

[in] Handle

The device handle for the PEP for the target processor. If NULL, the notification does not target a specific processor.

[in] Notification

The PPM notification ID. This parameter specifies the type of PPM notification that PoFx is sending. For a list of PPM notification IDs, see Processor power management (PPM) notifications.

[in, out, optional] Data

A pointer to a PoFx-allocated structure that contains the input and/or output data for this notification. The type of this structure depends on the notification ID specified by Notification. For a list of the structure types that are defined for the various PPM notification IDs, see Processor power management (PPM) notifications.

Return value

The AcceptProcessorNotification routine must return TRUE if it handles the notification, or FALSE if it does not.

Remarks

This routine is implemented by the platform extension plug-in (PEP) for a processor. The AcceptProcessorNotification member of the PEP_INFORMATION structure is a pointer to an AcceptProcessorNotification routine. The PEP calls the PoFxRegisterPlugin or PoFxRegisterPluginEx routine to register the PEP's AcceptProcessorNotification routine with PoFx.

The IRQL at which the PEP's AcceptProcessorNotification routine is called varies according to the type of notification that is being sent. The context in which this interface is called ranges from PASSIVE_LEVEL to HIGH_LEVEL with interrupts disabled. For more information about the IRQL at which each notification type is sent, see the individual reference pages under Processor power management (PPM) notifications.

Requirements

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