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 windows framework di risparmio energia (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 lo stato di inattività della piattaforma PEP specificato N, gli indici di stato di inattività della piattaforma validi sono compresi tra 0 e 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 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 di errore possibili includono i codici di stato seguenti.
| Valore restituito | Descrizione |
|---|---|
|
Il numero di versione nella struttura PEP_PLATFORM_IDLE_STATE_UPDATE non è supportato. |
|
La routine UpdatePlatformIdleState non viene implementata per questo processore. |
Osservazioni
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 UpdatePlatformIdle State.
Il PEP deve attendere fino al completamento di tutte le notifiche di PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE per chiamare la routine UpdatePlatformIdleState.
La routine updatePlatformIdleState deve essere chiamata in IRQL = PASSIVE_LEVEL.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato a partire da Windows 10. |
| piattaforma di destinazione | Finestre |
| intestazione | pepfx.h (include Pep_x.h) |
| IRQL | PASSIVE_LEVEL |
Vedere anche
PEP_KERNEL_INFORMATION_STRUCT_V3
PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE