Funzione di callback POFXCALLBACKUPDATEPROCESSORIDLESTATE (pepfx.h)

Articolo
08/07/2023

La routine UpdateProcessorIdleState viene chiamata dal plug-in di 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 risparmio energia di Windows (PoFx). Il PEP ha ricevuto in precedenza questo handle da PoFx durante la notifica PEP_DPM_REGISTER_DEVICE che informava 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 di PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2 precedente, il PEP ha specificato il numero di stati di inattività del processore supportati e le proprietà di questi stati. Se lo stato di inattività del processore PEP specificato N, gli indici di stato di inattività del processore validi sono compreso 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 di errore 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 ed è 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	pepfx.h (include Pep_x.h)
IRQL	PASSIVE_LEVEL

Vedi anche

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_PROCESSOR_IDLE_STATE_UPDATE

Condividi tramite