Funzione PoFxRegisterCoreDevice (pepfx.h)
La routine PoFxRegisterCoreDevice registra una nuova risorsa di sistema principale con il framework di gestione power di Windows (PoFx).
Sintassi
NTSTATUS PoFxRegisterCoreDevice(
[in] PCUNICODE_STRING Id,
[in] PPO_FX_CORE_DEVICE Device,
[out] POHANDLE *Handle
);
Parametri
[in] Id
Stringa che identifica in modo univoco la risorsa di sistema principale. Questo membro è un puntatore a una struttura UNICODE_STRING che contiene una stringa di identificazione del dispositivo.
[in] Device
Puntatore a una struttura PO_FX_CORE_DEVICE che descrive le caratteristiche di potenza della risorsa di sistema principale.
[out] Handle
Puntatore a una posizione in cui la routine scrive un valore POHANDLE. Questo handle rappresenta la registrazione della risorsa di sistema principale con PoFx.
Valore restituito
PoFxRegisterCoreDevice restituisce STATUS_SUCCESS se la chiamata registra correttamente il PEP. I valori restituiti degli errori possibili includono i codici di stato seguenti.
Valore restituito | Descrizione |
---|---|
|
Il conteggio dei componenti per questo dispositivo è zero o la struttura PO_FX_CORE_DEVICE contiene un numero di versione non valido o il membro ComponentCriticalTransitionCallback di questa struttura contiene un puntatore alla funzione non valido. |
|
Impossibile allocare le risorse necessarie per completare la registrazione richiesta. |
Commenti
Questa routine registra una risorsa di sistema principale in modo che questa risorsa possa essere gestita da PoFx.
Le risorse di sistema principali sono dispositivi hardware, ad esempio timer e controller di interruzione, gestiti dal livello di astrazione hardware windows (HAL). Questi dispositivi forniscono funzioni di base necessarie dal sistema operativo. A causa della stretta relazione tra le risorse di base del sistema e i processori, la gestione della potenza di queste risorse deve essere coordinata con la gestione dello stato inattiva del processore.
La routine PoFxRegisterCoreDevice deve essere chiamata in IRQL = PASSIVE_LEVEL.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile a partire da Windows 10. |
Piattaforma di destinazione | Windows |
Intestazione | pepfx.h (includere Pep_x.h) |
Libreria | Ntoskrnl.lib |
IRQL | PASSIVE_LEVEL |