Funzione di callback POFXCALLBACKUPDATEPLATFORMIDLESTATE (pepfx.h)

Articolo
08/07/2023

La routine UpdatePlatformIdleState viene chiamata dal plug-in dell'estensione della piattaforma (PEP) per aggiornare le proprietà dello stato di inattività della piattaforma specificato.

Sintassi

POFXCALLBACKUPDATEPLATFORMIDLESTATE Pofxcallbackupdateplatformidlestate;

NTSTATUS Pofxcallbackupdateplatformidlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG PlatformState,
  [in] PPEP_PLATFORM_IDLE_STATE_UPDATE Update
)
{...}

Parametri

[in] ProcessorHandle

Valore POHANDLE che rappresenta la registrazione del processore (come dispositivo) con il framework di gestione power di Windows (PoFx). Il PEP ha ricevuto in precedenza questo handle da PoFx durante la notifica PEP_DPM_REGISTER_DEVICE che ha informato il PEP che il processore era stato registrato con PoFx.

[in] PlatformState

Indice che identifica lo stato di inattività della piattaforma le cui proprietà devono essere aggiornate. In risposta a una notifica di PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES precedente, il PEP ha specificato il numero di stati di inattività della piattaforma supportati. Se l'inattività della piattaforma PEP specificato N indica l'inattività della piattaforma, gli indici di stato inattive della piattaforma validi sono compresi tra 0 e N-1. In risposta a una notifica precedente PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE , il PEP ha specificato le proprietà di questo stato di inattività della piattaforma.

[in] Update

Puntatore a una struttura PEP_PLATFORM_IDLE_STATE_UPDATE che contiene le proprietà aggiornate dello stato di inattività della piattaforma.

Valore restituito

UpdatePlatformIdleState restituisce STATUS_SUCCESS se aggiorna correttamente le proprietà dello stato di inattività della piattaforma. I valori restituiti degli errori possibili includono i codici di stato seguenti.

Valore restituito	Descrizione
STATUS_NOT_SUPPORTED	Il numero di versione nella struttura PEP_PLATFORM_IDLE_STATE_UPDATE non è un valore supportato.
STATUS_NOT_IMPLEMENTED	La routine UpdatePlatformIdleState non viene implementata per questo processore.

Commenti

Questa routine viene implementata da PoFx e viene chiamata dal PEP. Il membro UpdatePlatformIdleState della struttura PEP_KERNEL_INFORMATION_STRUCT_V3 è un puntatore a una routine UpdatePlatformIdleState .

Il PEP deve attendere fino al completamento di tutte le notifiche PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE per chiamare la routine UpdatePlatformIdleState .

La routine UpdatePlatformIdleState deve essere chiamata in IRQL = PASSIVE_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato a partire da Windows 10.
Piattaforma di destinazione	Windows
Intestazione	pepfx.h (includere Pep_x.h)
IRQL	PASSIVE_LEVEL

Vedi anche

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

Condividi tramite