WdfDeviceSetStaticStopRemove-Funktion (wdfdevice.h)

Artikel
03/22/2025

[Gilt für KMDF und UMDF]

Die WdfDeviceSetStaticStopRemove Methode informiert das Framework darüber, ob ein Gerät beendet und entfernt werden kann.

Syntax

void WdfDeviceSetStaticStopRemove(
  [in] WDFDEVICE Device,
  [in] BOOLEAN   Stoppable
);

Die Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

[in] Stoppable

Ein boolescher Wert, der angibt, ob das angegebene Gerät beendet und entfernt werden kann. Wenn TRUE, kann das Gerät beendet und entfernt werden. Wenn FALSE-, kann das Gerät nicht beendet und entfernt werden.

Rückgabewert

Nichts

Bemerkungen

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Standardmäßig kann ein Gerät beendet und entfernt werden. Daher ruft ein Treiber in der Regel WdfDeviceSetStaticStopRemove nur auf, wenn er den parameter Stoppable vorübergehend auf FALSEfestlegen muss. Beispielsweise kann ein Treiber, der einen DVD-Writer steuert, WdfDeviceSetStaticStopRemove- aufrufen, wobei stoppbare auf FALSE- festgelegt ist, bevor es mit dem Brennen einer DVD beginnt. Nachdem der Treiber das Brennen der DVD beendet hat, würde er WdfDeviceSetStaticStopRemove erneut aufrufen, wobei Stoppable auf TRUEfestgelegt ist.

Wenn das Gerät des Treibers eine spezielle Datei unterstützt (siehe WdfDeviceSetSpecialFileSupport), lässt das Framework das Beenden oder Entfernen des Geräts nicht zu. In diesem Fall muss Der Treiber nicht WdfDeviceSetStaticStopRemove aufrufen.

Der Treiber muss jedem Aufruf von WdfDeviceSetStaticStopRemove- entsprechen, wobei stoppbareauf "FALSE" festgelegt ist, mit einem Aufruf von WdfDeviceSetStaticStopRemove mit Stoppable auf TRUEfestgelegt ist.

Das Aufrufen WdfDeviceSetStaticStopRemove mit stoppbaren auf FALSE festgelegt ist, verhindert nicht, dass das Framework den Treiber benachrichtigt, wenn das Gerät unerwartet entfernt wird (Überraschung entfernt).

Weitere Informationen zum Verhindern, dass das Betriebssystem ein Gerät beendet, finden Sie unter Behandeln von Anforderungen zum Beenden eines Geräts.

Beispiele

Im folgenden Codebeispiel wird das Framework darüber informiert, dass das angegebene Gerät nicht beendet und entfernt werden kann.

WdfDeviceSetStaticStopRemove(
                             device,
                             FALSE
                             );

Anforderungen

Anforderung	Wert
Zielplattform	universell
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Kopfzeile	wdfdevice.h (einschließen Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Freigeben über