Freigeben über

IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove-Methode (wudfddi.h)

  • Artikel

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]

Die OnRemoteTargetQueryRemove Ereignisrückruffunktion eines UMDF-basierten Treibers bestimmt, ob das Gerät eines Remote-E/A-Ziels beendet und entfernt werden kann.

Syntax

BOOL OnRemoteTargetQueryRemove(
  [in] IWDFRemoteTarget *pWdfRemoteTarget
);

Parameter

[in] pWdfRemoteTarget

Ein Zeiger auf die IWDFRemoteTarget Schnittstelle eines Remotezielobjekts, das ein Remote-E/A-Zieldarstellt. Der Treiber ruft diesen Zeiger ab, wenn er IWDFDevice2::CreateRemoteTargetaufruft.

Rückgabewert

Wenn der Treiber feststellt, dass das Gerät beendet und entfernt werden kann, muss die OnRemoteTargetQueryRemove Ereignisrückruffunktion TRUEzurückgeben. Andernfalls muss die Rückruffunktion FALSE-zurückgeben.

Bemerkungen

Wenn Ihr Treiber eine OnRemoteTargetQueryRemove Ereignisrückruffunktion bereitstellt, sollte die Rückruffunktion bestimmen, ob das Betriebssystem das Entfernen des Geräts zulassen soll. Wenn der Treiber feststellt, dass das Gerät entfernt werden kann, sollte folgendes ausgeführt werden:

  1. Führen Sie alle treiberspezifischen Aktionen aus, die zum Beenden von E/A an das Remoteziel erforderlich sind.
  2. Rufen Sie IWDFRemoteTarget::CloseForQueryRemoveauf.
  3. Gibt TRUE- zurück, um anzugeben, dass das Entfernen auftreten kann.
Wenn der Treiber feststellt, dass das Gerät nicht entfernt werden soll, muss die Rückruffunktion FALSE-zurückgeben. In der Regel sollten Treiber vermeiden, FALSE-zurückzugeben, da ein FALSE Rückgabewert dazu führen kann, dass Windows neu gestartet wird.

Wenn der Treiber diese Rückruffunktion nicht bereitstellt, ruft das Framework IWDFRemoteTarget::CloseForQueryRemove für den Treiber auf. Mit anderen Worten, das Framework ermöglicht es immer, das Gerät zu entfernen, es sei denn, der Treiber stellt eine OnRemoteTargetQueryRemove Ereignisrückruffunktion bereit.

Weitere Informationen zur OnRemoteTargetQueryRemove Ereignisrückruffunktion finden Sie unter Controlling a General I/O Target's State in UMDF.

Anforderungen

Anforderung Wert
Ende des Supports In UMDF 2.0 und höher nicht verfügbar.
Zielplattform- Desktop
Mindest-UMDF-Version 1.9
Header- wudfddi.h (include Wudfddi.h)

Siehe auch

IRemoteTargetCallbackRemoval

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete