Funzione PoFxStartDevicePowerManagement (wdm.h)

La routine PoFxStartDevicePowerManagement completa la registrazione di un dispositivo con il framework di risparmio energia (PoFx) e avvia il risparmio energia del dispositivo.

Sintassi

void PoFxStartDevicePowerManagement(
  [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

Dopo che un driver chiama la routine PoFxRegisterDevice per registrare un dispositivo con PoFx, tutti i componenti del dispositivo sono completamente attivi e nella condizione attiva in modo che il driver possa completare l'inizializzazione dell'hardware. Per avviare il risparmio energia attivo, il driver deve chiamare PoFxStartDevicePowerManagement. Per impostazione predefinita, questa chiamata passa tutti i componenti alla condizione di inattività.

Dopo che PoFxStartDevicePowerManagement passa un componente alla condizione di inattività, PoFx potrebbe iniziare immediatamente a chiamare le routine di callback del driver, anche prima che PoFxStartDevicePowerManagement restituisca. PoFx chiama la routine di callback ComponentIdleConditionCallback del driver per indicare che un componente è passato alla condizione di inattività. Il driver non deve accedere a un componente che si trova nella condizione di inattività. Prima che il driver possa accedere al componente, il driver deve chiamare PoFxActivateComponent e attendere che PoFx chiami la routine di callback ComponentActiveConditionCallback del driver. Questo callback informa il driver che il componente si trova nella condizione attiva ed è possibile accedervi in modo sicuro.

Se il driver richiede che un componente si trova nella condizione attiva immediatamente dopo l'avvio del risparmio energia, il driver deve attivare esplicitamente il componente chiamando la routine PoFxActivateComponent e questa chiamata deve essere eseguita dopo la chiamata PoFxRegisterDevice ma prima della chiamata PoFxStartDevicePowerManagement .

Requisiti

Vedi anche

ComponentActiveConditionCallback

ComponentIdleConditionCallback

PoFxActivateComponent

PoFxRegisterDevice