EVT_WDF_DEVICE_SURPRISE_REMOVAL Rückruffunktion (wdfdevice.h)

Artikel
02/29/2024

[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 ein Treiber meldet, dass das Gerät ausgefallen ist.

Syntax

EVT_WDF_DEVICE_SURPRISE_REMOVAL EvtWdfDeviceSurpriseRemoval;

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

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

Rückgabewert

Keine

Bemerkungen

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

Das Framework synchronisiert die Rückruffunktion EvtDeviceSurpriseRemoval nicht 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 entfernt ein Gerät.

Anforderungen

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

Freigeben über