Supporto di Wake-Up di sistema nei driver UMDF

Avviso

UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2.

Gli esempi di UMDF 1 archiviati sono disponibili nell'Windows 11, versione 22H2 - Aggiornamento degli esempi di driver di maggio 2022.

Per altre informazioni, vedere Introduzione con UMDF.

Mentre il sistema si trova in uno stato a bassa potenza, alcuni dispositivi possono rilevare un evento esterno, ad esempio un pacchetto di rete in ingresso, e quindi riattivare il sistema. Ad esempio, se un dispositivo PCI ha una funzionalità di riattivazione del sistema, come indicato nella registrazione delle funzionalità di risparmio energia (PMC) del dispositivo, viene riattivato il sistema generando il segnale di Power Management Event (PME) sul bus PCI.

Se il dispositivo può riattivare il sistema da uno stato di bassa potenza a livello di sistema, la funzione IDriverEntry::OnDeviceAdd callback nel proprietario dei criteri di alimentazione deve eseguire i due passaggi seguenti:

1. Chiamare IWDFDevice2::AssignSxWakeSettings per specificare:

   • Stato di bassa potenza immesso dal dispositivo
   • Indica se gli utenti possono controllare le impostazioni inattive del dispositivo
   • Se la funzionalità di riattivazione del dispositivo è abilitata o disabilitata

2. Implementare l'interfaccia IPowerPolicyCallbackWakeFromSx e le seguenti funzioni di callback degli eventi, se necessarie per il dispositivo:

   • IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx, che consente all'hardware del dispositivo di rispondere a un evento di riattivazione esterno.
   • IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx, che disabilita la possibilità del dispositivo di rispondere a un evento di riattivazione esterno.
   • IPowerPolicyCallbackWakeFromSx::OnWakeFromSxTriggered, che informa il conducente che il bus ha rilevato un segnale di riattivazione.

Anche i conducenti del bus partecipano alla svegliazione del sistema. Il driver in modalità kernel per il bus del dispositivo esegue qualsiasi operazione necessaria sulla scheda del bus per abilitare e disabilitare la capacità di un dispositivo di riattivare da uno stato di bassa potenza.

Per informazioni sulle voci del Registro di sistema che controllano le funzionalità di riattivazione di un dispositivo, vedere Controllo utente dell'inattività del dispositivo e comportamento di riattivazione in UMDF.