Funzione PoFxRegisterCoreDevice (pepfx.h)

Articolo
02/29/2024

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
STATUS_INVALID_PARAMETER	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.
STATUS_INSUFFICIENT_RESOURCES	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

Vedi anche

PO_FX_CORE_DEVICE

UNICODE_STRING

Condividi tramite