EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT Rückruffunktion (wdfdevice.h)

  • Artikel

[Gilt für KMDF und UMDF]

Die EvtDeviceSelfManagedIoInit-Ereignisrückruffunktion eines Treibers initialisiert und startet die selbstverwalteten 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 für ein Framework-Geräteobjekt.

Rückgabewert

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

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

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

Hinweise

Um eine EvtDeviceSelfManagedIoInit-Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPnpPowerEventCallbacks aufrufen.

Wenn der Treiber eine EvtDeviceSelfManagedIoInit-Rückruffunktion registriert hat, ruft das Framework diese einmal für jedes Gerät auf, nachdem das Framework die EvtDeviceD0Entry-Rückruffunktion des Treibers zum ersten Mal 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 wieder verbunden oder die Treiber werden erneut geladen.

Die Rückruffunktion EvtDeviceSelfManagedIoInit muss die selbstverwalteten E/A-Vorgänge initialisieren und 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 Energieverwaltungsszenarien.

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

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfdevice.h (einschließen von Wdf.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

EvtDeviceSelfManagedIoCleanup

EvtDeviceSelfManagedIoFlush

EvtDeviceSelfManagedIoRestart

EvtDeviceSelfManagedIoSuspend