EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT funzione di callback (wdfdevice.h)
[Si applica a KMDF e UMDF]
La funzione di callback dell'evento EvtDeviceSelfManagedIoInit di un driver inizializza e avvia le operazioni di I/O self-managed 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 la funzione di callback EvtDeviceSelfManagedIoInit 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 non avvia il 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 EvtDeviceSelfManagedIoInit , un driver deve chiamare WdfDeviceInitSetPnpPowerEventCallbacks.
Se il driver ha registrato una funzione di callback EvtDeviceSelfManagedIoInit , il framework lo chiama una volta per ogni dispositivo, dopo che il framework ha chiamato la funzione di callback EvtDeviceD0Entry del driver per la prima volta. Il framework non chiama nuovamente la funzione di callback EvtDeviceSelfManagedIoInit per tale dispositivo, a meno che il dispositivo non venga rimosso e riconnesso o che i driver vengano ricaricati.
La funzione di callback EvtDeviceSelfManagedIoInit deve inizializzare e avviare le operazioni di I/O auto-gestite dal driver per il 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.
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 |