Funzione di callback POFXCALLBACKUPDATEPLATFORMIDLESTATE (pepfx.h)
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 |
|---|---|
|
Il numero di versione nella struttura PEP_PLATFORM_IDLE_STATE_UPDATE non è un valore supportato. |
|
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_KERNEL_INFORMATION_STRUCT_V3
PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE