EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT funzione di callback (wdfdevice.h)
[Si applica a KMDF e UMDF]
La funzione di callback di un driver EvtDeviceSelfManagedIoInit inizializza e avvia le operazioni di I/O autogestito del dispositivo.
Sintassi
EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT EvtWdfDeviceSelfManagedIoInit;
NTSTATUS EvtWdfDeviceSelfManagedIoInit(
[in] WDFDEVICE Device
)
{...}
Parametri
[in] Device
Handle per un oggetto dispositivo framework.
Valore restituito
Se il EvtDeviceSelfManagedIoInit funzione di callback non rileva errori, deve restituire STATUS_SUCCESS o un altro valore di stato per il quale NT_SUCCESS( stato) è uguale 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 non avvia il 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 EvtDeviceSelfManagedIoInit funzione di callback, un driver deve chiamare WdfDeviceInitSetPnpPowerEventCallbacks.
Se il driver ha registrato un EvtDeviceSelfManagedIoInit funzione di callback, il framework lo chiama una volta per ogni dispositivo, dopo che il framework ha chiamato il driver EvtDeviceD0Entry funzione di callback per la prima volta. Il framework non chiama di nuovo il EvtDeviceSelfManagedIoInit funzione di callback per tale dispositivo, a meno che il dispositivo non venga rimosso e riconnesso o che i driver vengano ricaricati.
Il EvtDeviceSelfManagedIoInit funzione di callback deve inizializzare e avviare le operazioni di I/O autogestito che il driver gestirà per il 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.
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 |