Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità 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. Per altre informazioni, vedi Introduzione a UMDF.]
Un driver OnArmWakeFromSx le braccia della funzione di callback degli eventi ,ovvero abilita, un dispositivo in modo che possa attivare un segnale di riattivazione mentre è in uno stato di dispositivo a basso consumo. Il segnale di riattivazione fa sì che il dispositivo entri nello stato di lavoro (D0) e che il sistema entri nello stato di lavoro (S0).
Sintassi
HRESULT OnArmWakeFromSx(
[in] IWDFDevice *pWdfDevice
);
Parametri
[in] pWdfDevice
Puntatore all'interfaccia IWDFDevice dell'oggetto dispositivo che rappresenta uno dei dispositivi del driver.
Valore restituito
Se l'operazione ha esito positivo, la funzione di callback di OnArmWakeFromS x deve restituire S_OK o un altro valore di stato per cui SUCCEEDED(status) è uguale TRUE. In caso contrario, deve restituire un valore di stato per il quale SUCCEEDED( stato) è uguale a FALSE.
Se SUCCEEDED(status) è uguale FALSE, il framework chiama la funzione di callback del driver IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromS x. Il framework non segnala un errore del dispositivo al gestore PnP.
Osservazioni
Il driver deve fornire una funzione di callback OnArmWakeFromSx se il driver supporta l'interfaccia IPowerPolicyCallbackWakeFromSx.
Questa funzione di callback gestisce operazioni specifiche del dispositivo necessarie per consentire al dispositivo di rilevare un evento esterno che attiva un segnale di riattivazione sul bus. Il driver del bus in modalità kernel gestisce operazioni specifiche del bus, ad esempio l'abilitazione del segnale di power management event (PME) del bus PCI.
Se un driver ha registrato un OnArmWakeFromSx funzione di callback, il framework lo chiama mentre il dispositivo è ancora nello stato di alimentazione del dispositivo D0, prima che il driver del bus abbassa lo stato di alimentazione del dispositivo, ma dopo che il framework ha inviato un IRP di attesa/riattivazione per conto del driver.
Il processo si verifica nella sequenza seguente:
- Il framework determina che il sistema sta per entrare in uno stato di sistema a basso consumo.
- Il framework chiama la funzione di callback del driver OnArmWakeFromSx.
- Il framework chiede al conducente il bus del dispositivo di ridurre la potenza del dispositivo.
Per altre informazioni sui casi in cui il framework chiama questa funzione di callback, vedere Scenari di risparmio energia e PnP in UMDF.
Non è necessario fornire un OnArmWakeFromSx funzione di callback se il dispositivo non richiede operazioni hardware speciali che consentono al dispositivo di attivare un segnale di riattivazione.
Per altre informazioni su questa funzione di callback, vedere Support System Wake-Up in Driver basati su UMDF.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.9 |
| intestazione | wudfddi.h (include Wudfddi.h) |
Vedere anche
IPowerPolicyCallbackWakeFromSx