Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Gilt für KMDF und UMDF]
Die EvtDeviceSelfManagedIoSuspend Ereignisrückruffunktion eines Geräts hält die selbstverwaltete E/A-Vorgänge eines Geräts an.
Syntax
EVT_WDF_DEVICE_SELF_MANAGED_IO_SUSPEND EvtWdfDeviceSelfManagedIoSuspend;
NTSTATUS EvtWdfDeviceSelfManagedIoSuspend(
[in] WDFDEVICE Device
)
{...}
Parameter
[in] Device
Ein Handle zu einem Framework-Geräteobjekt.
Rückgabewert
Wenn der Vorgang erfolgreich ist, muss die EvtDeviceSelfManagedIoSuspend Rückruffunktion STATUS_SUCCESS zurückgeben, oder ein anderer Statuswert, für den NT_SUCCESS(Status) TRUEist. Andernfalls muss ein Statuswert zurückgegeben werden, für den NT_SUCCESS(Status) FALSE-entspricht. Wenn NT_SUCCESS(Status) gleich FALSE-ist, beendet das Framework das Gerät und entfernt seine Geräteobjekte.
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 EvtDeviceSelfManagedIoSuspend Rückruffunktion zu registrieren, muss ein Treiber WdfDeviceInitSetPnpPowerEventCallbacksaufrufen.
Wenn der Treiber einen EvtDeviceSelfManagedIoSuspend Callbackfunktion registriert hat, ruft das Framework ihn aus einem der folgenden Gründe auf:
- Das Gerät ist dabei, einen Energiesparzustand einzugeben.
- Das Gerät wird entfernt oder wurde überrascht.
- Der Plug and Play-Manager ist dabei, die Hardwareressourcen des Systems auf die angeschlossenen Geräte des Systems weiterzuverteilen.
Wenn das Gerät in einen Energiesparzustand versetzt werden soll, ruft das Framework die EvtDeviceSelfManagedIoSuspend Rückruffunktion auf, bevor er die EvtDeviceD0Exit Rückruffunktion des Treibers aufruft.
Wenn die Rückruffunktion einen Statuswert zurückgibt, für den NT_SUCCESS(Status) FALSE-entspricht. Wenn das Framework versucht, die Leistung des Geräts zu senken, stoppt das Framework das Gerät und entfernt seine Geräteobjekte.
Die EvtDeviceSelfManagedIoSuspend Rückruffunktion muss alles tun, was erforderlich ist, um die selbstverwaltete E/A-Vorgänge des Geräts zu beenden.
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-.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfdevice.h (einschließen Wdf.h) |
| IRQL- | PASSIVE_LEVEL |