EVT_HIDSPICX_NOTIFY_POWERDOWN funzione di callback (hidspicx.h)
Il EvtHidspicxNotifyPowerdown funzione di callback viene implementata dal driver client per ricevere notifiche quando il dispositivo sta per passare a uno stato a basso consumo.
Sintassi
EVT_HIDSPICX_NOTIFY_POWERDOWN EvtHidspicxNotifyPowerdown;
NTSTATUS EvtHidspicxNotifyPowerdown(
WDFDEVICE Device,
BOOLEAN ArmForWake
)
{...}
Parametri
Device
Handle per un oggetto dispositivo framework il driver client ottenuto da una chiamata precedente a WdfDeviceCreate.
ArmForWake
Valore booleano che indica se il dispositivo sarà armato per la riattivazione nello stato di destinazione per la transizione di alimentazione in sospeso.
Valore restituito
NTSTATUS che indica se la preparazione per la transizione di alimentazione ha avuto esito positivo o negativo. Questo metodo non dovrebbe avere esito negativo in fase di esecuzione e potrebbe causare un errore del dispositivo da HidSpiCx.
Osservazioni
Si prevede che il driver client implementi e fornisca un callback che HidSpiCx userà per notificare al client un'interruzione dell'alimentazione in sospeso. Lo scopo di questo callback è consentire all'estensione della classe di indicare al client di interrompere l'elaborazione degli interrupt dal dispositivo, perché il dispositivo sta per entrare in uno stato a basso consumo. Il client non deve riprendere l'elaborazione degli interrupt finché non si è verificato un callback al callback WDF D0Entry del client.
Lo scopo di questa funzione è evitare il caso in cui si entra in uno stato di sospensione in cui l'estensione della classe invia un comando SET_POWER SLEEP al dispositivo e il dispositivo asserisce l'interruzione di riattivazione prima che l'IRP Dx venga completato sia dall'estensione della classe che dal driver client. Senza un callback aggiuntivo che indica al client di arrestare l'elaborazione hardware di interrupt, l'hardware emette una lettura SPI in risposta a un interrupt di riattivazione, che viola il protocollo che richiede all'host di inviare un comando SET_POWER ON prima di elaborare gli interrupt dal dispositivo.
Questa funzione verrà chiamata dall'estensione della classe in IRQL passivo e il client non deve restituire finché l'elaborazione dell'interrupt non viene interrotta.
Se il dispositivo sarà armato per la riattivazione a livello di autobus viene fornito al client come comodità, consentendo al conducente client di evitare il monitoraggio per i comandi WAIT_WAKE se non è un autista di autobus.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 11 |
| intestazione | hidspicx.h |
| IRQL | PASSIVE_LEVEL |