EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART Rückruffunktion (wdfdevice.h)

[Gilt für KMDF und UMDF]

Die EvtDeviceSelfManagedIoRestart Ereignisrückruffunktion eines Geräts startet die selbstverwaltete E/A-Vorgänge eines Geräts neu.

Syntax

EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART EvtWdfDeviceSelfManagedIoRestart;

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

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

Rückgabewert

Wenn die EvtDeviceSelfManagedIoRestart 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) FALSE-entspricht, stoppt das Framework das Gerät und entlädt die Treiber des Geräts.

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 EvtDeviceSelfManagedIoRestart Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPnpPowerEventCallbacksaufrufen.

Wenn der Treiber eine EvtDeviceSelfManagedIoRestart Rückruffunktion registriert hat, ruft das Framework jedes Mal, wenn das Gerät von einem Energiesparzustand in den Arbeitszustand (D0) zurückgibt, auf. Das Framework ruft die EvtDeviceSelfManagedIoRestart Rückruffunktion erst nach dem Aufrufen der EvtDeviceSelfManagedIoSuspend Rückruffunktion auf.

Die EvtDeviceSelfManagedIoRestart Rückruffunktion des Treibers muss alles tun, was erforderlich ist, um die selbstverwaltete E/A-Vorgänge des Geräts fortzusetzen.

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-.

Die EvtDeviceSelfManagedIoRestart Rückruffunktion wird bei IRQL = PASSIVE_LEVEL aufgerufen. Sie sollten diese Rückruffunktion nicht seitenseitigenvornehmen.

Anforderungen

Siehe auch

EvtDeviceSelfManagedIoCleanup

EvtDeviceSelfManagedIoFlush

EvtDeviceSelfManagedIoInit

EvtDeviceSelfManagedIoSuspend