Condividi tramite

Funzione PoFxReportDevicePoweredOn (wdm.h)

  • Articolo

La routine PoFxReportDevicePoweredOn notifica al framework di risparmio energia (PoFx) che il dispositivo ha completato la transizione richiesta allo stato di alimentazione D0 (completamente acceso).

Sintassi

void PoFxReportDevicePoweredOn(
  [in] POHANDLE Handle
);

Parametri

[in] Handle

Handle che rappresenta la registrazione del dispositivo con il framework di risparmio energia (PoFx). Il driver di dispositivo ha ricevuto in precedenza questo handle dalla routine PoFxRegisterDevice .

Valore restituito

nessuno

Osservazioni

Il driver per un dispositivo registrato deve chiamare PoFxReportDevicePoweredOn dopo una delle occorrenze seguenti:

  • PoFx chiama la routine di callback DevicePowerRequiredCallback del driver per notificare al driver che il dispositivo deve immettere lo stato di alimentazione D0.
  • PoFx chiama la routine di callback DirectedPowerUpCallback del driver per notificare al driver che il dispositivo deve immettere lo stato di alimentazione D0.
  • PoFx invia al driver un IRP S0 (una richiesta di IRP_MN_SET_POWER ) per notificare al driver una transizione di sistema in sospeso allo stato di alimentazione S0.
In risposta a entrambe le occorrenze, il driver invia IRP D0 (una richiesta di IRP_MN_SET_POWER ) allo stack di dispositivi per avviare una transizione allo stato di alimentazione D0, se il dispositivo non è già nello stato D0. Al termine del driver (e tutti i driver inferiori) la transizione allo stato D0, il driver chiama PoFxReportDevicePoweredOn per inviare una notifica a PoFx.

Il driver deve chiamare PoFxReportDevicePoweredOn indipendentemente dal fatto che non sia richiesto alcun IRP D0, che la richiesta D0 IRP abbia esito negativo, che D0 IRP inviato abbia esito positivo o negativo oppure che L'IRP S0 abbia esito positivo o negativo.

Per il callback di alimentazione richiesta/diretta, la chiamata PoFxReportDevicePoweredOn può verificarsi durante o dopo la chiamata di callback.

Per una richiesta IRP S0, il driver deve completare questa richiesta il prima possibile, passare il dispositivo allo stato di alimentazione D0 e chiamare PoFxReportDevicePoweredOn. Per altre informazioni, vedere Gestione di un Set-Power IRP di sistema in un proprietario di Criteri di risparmio energia del dispositivo.

All'ingresso di PoFxReportDevicePoweredOn, il dispositivo potrebbe trovarsi in uno stato di alimentazione D0 non inizializzato in cui tutti i componenti del dispositivo sono attivati. In risposta alla chiamata PoFxReportDevicePoweredOn , PoFx configura il dispositivo in uno stato D0 inizializzato. Durante questa configurazione, PoFx passa il maggior numero di componenti possibile agli stati di alimentazione fx a basso consumo.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8.
Piattaforma di destinazione Universale
Intestazione wdm.h
Libreria Ntoskrnl.lib
DLL Ntoskrnl.exe
IRQL <= DISPATCH_LEVEL

Vedi anche

DevicePowerRequiredCallback

IRP_MN_SET_POWER

PoFxRegisterDevice