EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT Rückruffunktion (wdfdevice.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die EvtDeviceSelfManagedIoInit Ereignisrückruffunktion initialisiert und startet die selbstverwaltete E/A-Vorgänge des Geräts.

Syntax

EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT EvtWdfDeviceSelfManagedIoInit;

NTSTATUS EvtWdfDeviceSelfManagedIoInit(
  [in] WDFDEVICE Device
)
{...}

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

Rückgabewert

Wenn die EvtDeviceSelfManagedIoInit Rückruffunktion keine Fehler auftritt, muss sie STATUS_SUCCESS oder einen anderen Statuswert zurückgeben, für den NT_SUCCESS(Status) TRUEentspricht. Andernfalls muss ein Statuswert zurückgegeben werden, für den NT_SUCCESS(Status) FALSE-entspricht. Wenn NT_SUCCESS(Status) gleich FALSE-ist, startet das Framework das Gerät nicht.

Wenn NT_SUCCESS(status) FALSE-ist, ruft das Framework die EvtDeviceSelfManagedIoFlush und EvtDeviceSelfManagedIoCleanup Rückruffunktionen auf.

Weitere Informationen zu den Rückgabewerten dieser Rückruffunktion finden Sie unter Melden von Gerätefehlern.

Bemerkungen

Um eine EvtDeviceSelfManagedIoInit Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPnpPowerEventCallbacksaufrufen.

Wenn der Treiber eine EvtDeviceSelfManagedIoInit Rückruffunktion registriert hat, ruft es das Framework einmal für jedes Gerät auf, nachdem das Framework die EvtDeviceD0Entry Rückruffunktion des Treibers aufgerufen hat. Das Framework ruft die EvtDeviceSelfManagedIoInit Rückruffunktion für dieses Gerät nicht erneut auf, es sei denn, das Gerät wird entfernt und erneut verbunden, oder die Treiber werden neu geladen.

Die EvtDeviceSelfManagedIoInit Rückruffunktion muss initialisieren und die selbstverwalteten E/A-Vorgänge starten, die der Treiber für das Gerät verarbeitet.

Weitere Informationen dazu, wann das Framework diese Rückruffunktion aufruft, finden Sie unter PnP- und Power Management-Szenarien.

Weitere Informationen zu Treibern, die diese Rückruffunktion bereitstellen, finden Sie unter Verwenden von Self-Managed E/A-.