EVT_WDF_DEVICE_ARM_WAKE_FROM_SX funzione di callback (wdfdevice.h)
[Si applica a KMDF e UMDF]
Un driver EvtDeviceArmWakeFromSx 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 del dispositivo a basso consumo. Il segnale di riattivazione fa sì che il dispositivo entri nello stato di lavoro (D0) e fa sì che il sistema entri nello stato di lavoro (S0).
Sintassi
EVT_WDF_DEVICE_ARM_WAKE_FROM_SX EvtWdfDeviceArmWakeFromSx;
NTSTATUS EvtWdfDeviceArmWakeFromSx(
[in] WDFDEVICE Device
)
{...}
Parametri
[in] Device
Handle per un oggetto dispositivo framework.
Valore restituito
Se la funzione di callback EvtDeviceArmWakeFromSx non rileva alcun errore, deve restituire STATUS_SUCCESS o un altro valore di stato per cui NT_SUCCESS(stato) è uguale a TRUE. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS( stato) è uguale a FALSE.
Se NT_SUCCESS(stato) è uguale a FALSE, il framework chiama la funzione di callback del driver EvtDeviceDisarmWakeFromSx. Il framework non segnala un errore del dispositivo al gestore PnP.
Osservazioni
Per registrare un EvtDeviceArmWakeFromSx funzione di callback, un driver deve chiamare WdfDeviceInitSetPowerPolicyEventCallbacks. I driver possono registrare una funzione di callback EvtDeviceArmWakeFromSx o un EvtDeviceArmWakeFromSxWithReason funzione di callback, ma non entrambi.
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 conducente del bus EvtDeviceEnableWakeAtBus funzione di callback gestisce operazioni specifiche del bus, ad esempio l'abilitazione del segnale DELL'evento di risparmio energia del bus PCI.
Se un driver ha registrato un EvtDeviceArmWakeFromSx o EvtDeviceArmWakeFromSxWithReason 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 il EvtDeviceArmWakeFromSx o EvtDeviceArmWakeFromSxWithReason funzione di callback.
- 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.
Non è necessario fornire un EvtDeviceArmWakeFromSx o EvtDeviceArmWakeFromSxWithReason 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 di riattivazione del sistema di supporto.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 2.0 |
| intestazione | wdfdevice.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |