Metodo IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx (wudfddi.h)
[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 info, vedi Introduzione con UMDF.]
Le braccia della funzione di callback dell'evento OnArmWakeFromSx di un driver (ovvero abilita) un dispositivo in modo che possa attivare un segnale di riattivazione in uno stato del 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 OnArmWakeFromSx deve restituire S_OK o un altro valore di stato per il quale SUCCEEDED(status) è uguale a TRUE. In caso contrario, deve restituire un valore di stato per il quale SUCCEEDED(status) è uguale a FALSE.
Se SUCCEEDED(status) è uguale a FALSE, il framework chiama la funzione di callback IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx del driver. Il framework non segnala un errore del dispositivo al gestore PnP.
Commenti
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 PME (Power Management Event) del bus PCI.
Se un driver ha registrato una funzione di callback OnArmWakeFromSx , 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 del sistema a basso consumo.
- Il framework chiama la funzione di callback OnArmWakeFromSx del driver.
- Il framework chiede al driver che il bus del dispositivo riduce l'alimentazione 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 una funzione di callback OnArmWakeFromSx 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 Supporto dei Wake-Up di sistema nei driver basati su UMDF.
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1,9 |
| Intestazione | wudfddi.h (include Wudfddi.h) |
Vedi anche
IPowerPolicyCallbackWakeFromSx