Funzione di callback POFXCALLBACKUPDATEPROCESSORIDLESTATE (pep_x.h)

Articolo
02/29/2024

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

Sintassi

POFXCALLBACKUPDATEPROCESSORIDLESTATE Pofxcallbackupdateprocessoridlestate;

NTSTATUS Pofxcallbackupdateprocessoridlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG ProcessorState,
  [in] PPEP_PROCESSOR_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] ProcessorState

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

[in] Update

Puntatore a una struttura PEP_PROCESSOR_IDLE_STATE_UPDATE che contiene le proprietà aggiornate dello stato di inattività del processore.

Valore restituito

UpdateProcessorIdleState restituisce STATUS_SUCCESS se aggiorna correttamente le proprietà dello stato di inattività del processore. 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_PROCESSOR_IDLE_STATE_UPDATE non è un valore supportato.
STATUS_NOT_IMPLEMENTED	La routine UpdateProcessorIdleState non viene implementata per questo processore.

Commenti

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

La routine UpdateProcessorIdleState deve essere chiamata in IRQL = PASSIVE_LEVEL.

Requisiti

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

Vedi anche

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_PROCESSOR_IDLE_STATE_UPDATE

Condividi tramite