Skip to content

Latest commit

 

History

History
127 lines (89 loc) · 4.89 KB

nc-pepfx-pofxcallbackupdateplatformidlestate.md

File metadata and controls

127 lines (89 loc) · 4.89 KB
Raw
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NC:pepfx.POFXCALLBACKUPDATEPLATFORMIDLESTATE
POFXCALLBACKUPDATEPLATFORMIDLESTATE (pepfx.h)
The UpdatePlatformIdleState routine is called by the platform extension plug-in (PEP) to update the properties of the specified platform idle state.
kernel\updateplatformidlestate.htm
kernel
04/30/2018
POFXCALLBACKUPDATEPLATFORMIDLESTATE callback function
POFXCALLBACKUPDATEPLATFORMIDLESTATE, UpdatePlatformIdleState, UpdatePlatformIdleState routine [Kernel-Mode Driver Architecture], kernel.updateplatformidlestate, pepfx/UpdatePlatformIdleState
pepfx.h
Pep_x.h
Windows
Supported starting with Windows 10.
PASSIVE_LEVEL
Windows
POFXCALLBACKUPDATEPLATFORMIDLESTATE
pepfx/POFXCALLBACKUPDATEPLATFORMIDLESTATE
APIRef
kbSyntax
UserDefined
pepfx.h
POFXCALLBACKUPDATEPLATFORMIDLESTATE

POFXCALLBACKUPDATEPLATFORMIDLESTATE callback function (pepfx.h)

-description

The UpdatePlatformIdleState routine is called by the platform extension plug-in (PEP) to update the properties of the specified platform idle state.

-parameters

-param ProcessorHandle [in]

A POHANDLE value that represents the registration of the processor (as a device) with the Windows power management framework (PoFx). The PEP previously received this handle from PoFx during the PEP_DPM_REGISTER_DEVICE notification that informed the PEP that the processor had been registered with PoFx.

-param PlatformState [in]

An index that identifies the platform idle state whose properties are to be updated. In response to a previous PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES notification, the PEP specified the number of supported platform idle states. If the PEP specified N platform idle states, valid platform idle state indexes range from 0 to N-1. In response to a previous PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE notification, the PEP specified the properties of this platform idle state.

-param Update [in]

A pointer to a PEP_PLATFORM_IDLE_STATE_UPDATE structure that contains the updated properties of the platform idle state.

-returns

UpdatePlatformIdleState returns STATUS_SUCCESS if it successfully updates the properties of the platform idle state. Possible error return values include the following status codes.

Return value Description
STATUS_NOT_SUPPORTED
 The version number in the PEP_PLATFORM_IDLE_STATE_UPDATE structure is not a supported value.
STATUS_NOT_IMPLEMENTED
 The UpdatePlatformIdleState routine is not implemented for this processor.

-remarks

This routine is implemented by PoFx and is called by the PEP. The UpdatePlatformIdleState member of the PEP_KERNEL_INFORMATION_STRUCT_V3 structure is a pointer to an UpdatePlatformIdleState routine.

The PEP must wait until after it has completed all PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE notifications to call the UpdatePlatformIdleState routine.

The UpdatePlatformIdleState routine must be called at IRQL = PASSIVE_LEVEL.

-see-also

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES

PEP_PLATFORM_IDLE_STATE_UPDATE