Funzione di callback POFXCALLBACKUPDATEPLATFORMIDLESTATE (pep_x.h)
La routine UpdatePlatformIdleState viene chiamata dal plug-in di 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 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] 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 gli stati di inattività della piattaforma N specificati da PEP, gli indici di stato di inattività della piattaforma validi vanno da 0 a N-1. In risposta a una notifica di PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE precedente, il PEP ha specificato le proprietà di questo stato di inattività della piattaforma.
[in] Update
Puntatore a una struttura PEP_PLATFORM_IDLE_STATE_UPDATE contenente 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 di errore 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 ed è 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 | pep_x.h (includere Pep_x.h) |
| IRQL | PASSIVE_LEVEL |
Vedi anche
PEP_KERNEL_INFORMATION_STRUCT_V3
PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE