Funzione di callback POFXCALLBACKUPDATEPROCESSORIDLESTATE (pep_x.h)
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 |
|---|---|
|
Il numero di versione nella struttura PEP_PROCESSOR_IDLE_STATE_UPDATE non è un valore supportato. |
|
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 |