EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT funzione di callback (wdfdevice.h)

  • Articolo

[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

Vedi anche

EvtDeviceSelfManagedIoCleanup

EvtDeviceSelfManagedIoFlush

EvtDeviceSelfManagedIoRestart

EvtDeviceSelfManagedIoSuspend