EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART funzione di callback (wdfdevice.h)
[Si applica a KMDF e UMDF]
La funzione di callback di un driver EvtDeviceSelfManagedIoRestart riavvia le operazioni di I/O autogestito 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 EvtDeviceSelfManagedIoRestart funzione di callback 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) è uguale a FALSE. Se NT_SUCCESS(stato) è uguale a FALSE, il framework arresta il dispositivo e scarica i driver del dispositivo.
Se NT_SUCCESS(stato) è uguale a FALSE, il framework chiama le funzioni di callback evtDeviceSelfManagedIoFlush e EvtDeviceSelfManagedIoCleanup del driver.
Per altre informazioni sui valori restituiti di questa funzione di callback, vedere Segnalazione errori del dispositivo.
Osservazioni
Per registrare un EvtDeviceSelfManagedIoRestart funzione di callback, un driver deve chiamare WdfDeviceInitSetPnpPowerEventCallbacks.
Se il driver ha registrato un EvtDeviceSelfManagedIoRestart funzione di callback, il framework lo chiama ogni volta che il dispositivo torna da uno stato a basso consumo al relativo stato di funzionamento (D0). Il framework chiama la funzione di callback EvtDeviceSelfManagedIoRestart solo dopo aver chiamato la funzione di callback del driver EvtDeviceSelfManagedIoSuspend funzione di callback.
Il driver EvtDeviceSelfManagedIoRestart funzione di callback deve eseguire qualsiasi operazione necessaria per riprendere le operazioni di I/O autogestito del dispositivo.
Per altre informazioni sui casi in cui il framework chiama questa funzione di callback, vedere scenari di risparmio energia e PnP.
Per altre informazioni sui driver che forniscono questa funzione di callback, vedere Using Self-Managed I/O.
La EvtDeviceSelfManagedIoRestart funzione di callback viene chiamata in IRQL = PASSIVE_LEVEL. Non è consigliabile rendere questa funzione di callback pageable.
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 (vedere la sezione Osservazioni) |