EVT_WDF_DEVICE_SURPRISE_REMOVAL Rückruffunktion (wdfdevice.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

Die EvtDeviceSurpriseRemoval Ereignisrückruffunktion eines Treibers führt alle Vorgänge aus, die erforderlich sind, nachdem ein Gerät unerwartet aus dem System entfernt wurde, oder nachdem ein Treiber meldet, dass das Gerätfehlgeschlagen ist.

Syntax

EVT_WDF_DEVICE_SURPRISE_REMOVAL EvtWdfDeviceSurpriseRemoval;

void EvtWdfDeviceSurpriseRemoval(
  [in] WDFDEVICE Device
)
{...}

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

Rückgabewert

Nichts

Bemerkungen

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

Das Framework synchronisiert nicht die EvtDeviceSurpriseRemoval Rückruffunktion mit anderen PnP- und Power Management-Rückruffunktionen. Informationen dazu, wie das Framework die Ausführung der Ereignisrückruffunktionen eines Treibers synchronisiert, finden Sie unter Verwenden der automatischen Synchronisierung.

Weitere Informationen dazu, wann das Framework diese Rückruffunktion aufruft, und weitere Informationen zu Synchronisierungsproblemen finden Sie unter Ein Benutzer hebt ein Gerät.

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

Freigeben über