EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART funzione di callback (wdfdevice.h)
[Si applica a KMDF e UMDF]
La funzione di callback dell'evento EvtDeviceSelfManagedIoRestart di un driver riavvia le operazioni di I/O di un dispositivo.
Sintassi
EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART EvtWdfDeviceSelfManagedIoRestart;
NTSTATUS EvtWdfDeviceSelfManagedIoRestart(
[in] WDFDEVICE Device
)
{...}
Parametri
[in] Device
Handle per un oggetto dispositivo framework.
Valore restituito
Se la funzione di callback EvtDeviceSelfManagedIoRestart non rileva errori, deve restituire STATUS_SUCCESS o un altro valore di stato per il quale NT_SUCCESS(stato) è uguale a TRUE. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS(stato) equivale a FALSE. Se NT_SUCCESS(stato) è FALSE, il framework arresta il dispositivo e scarica i driver del dispositivo.
Se NT_SUCCESS(stato) è FALSE, il framework chiama le funzioni di callback evtDeviceSelfManagedIoFlush e EvtDeviceSelfManagedIoCleanup.
Per altre informazioni sui valori restituiti della funzione di callback, vedere Segnalazione di errori del dispositivo.
Commenti
Per registrare una funzione di callback EvtDeviceSelfManagedIoRestart , un driver deve chiamare WdfDeviceInitSetPnpPowerEventCallbacks.
Se il driver ha registrato una funzione di callback EvtDeviceSelfManagedIoRestart , il framework lo chiama ogni volta che il dispositivo restituisce da uno stato di bassa potenza allo stato funzionante (D0). Il framework chiama la funzione di callback EvtDeviceSelfManagedIoRestart solo dopo aver chiamato la funzione di callback EvtDeviceSelfManagedIoSuspend .
La funzione di callback EvtDeviceSelfManagedIoRestart del driver deve eseguire qualsiasi operazione necessaria per riprendere le operazioni di I/O self-managed del dispositivo.
Per altre informazioni su quando il framework chiama questa funzione di callback, vedere Scenari di Gestione energia e PnP.
Per altre informazioni sui driver che forniscono questa funzione di callback, vedere Uso di Self-Managed I/O.
La funzione di callback EvtDeviceSelfManagedIoRestart viene chiamata in IRQL = PASSIVE_LEVEL. Non è consigliabile rendere questa funzione di callback paginabile.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfdevice.h (includere Wdf.h) |
| IRQL | PASSIVE_LEVEL (vedere la sezione Osservazioni) |