IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. 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-Ziel darstellt. Der Treiber ruft diesen Zeiger ab, wenn er IWDFDevice2::CreateRemoteTarget aufruft.
Rückgabewert
Wenn der Treiber feststellt, dass das Gerät beendet und entfernt werden kann, muss die OnRemoteTargetQueryRemove-EreignisrückruffunktionTRUE zurückgeben. Andernfalls muss die Rückruffunktion FALSE zurückgeben.
Hinweise
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 er folgendes tun:
- Führen Sie alle treiberspezifischen Aktionen aus, die zum Beenden der E/A für das Remoteziel erforderlich sind.
- Rufen Sie IWDFRemoteTarget::CloseForQueryRemove auf.
- Geben Sie TRUE zurück, um anzugeben, dass die Entfernung erfolgen kann.
Wenn der Treiber diese Rückruffunktion nicht bereitstellt, ruft das Framework IWDFRemoteTarget::CloseForQueryRemove für den Treiber auf. Anders ausgedrückt: Das Framework ermöglicht immer das Entfernen des Geräts, es sei denn, der Treiber stellt eine OnRemoteTargetQueryRemove-Ereignisrückruffunktion bereit.
Weitere Informationen zur Ereignisrückruffunktion OnRemoteTargetQueryRemove finden Sie unter Steuern des Status eines allgemeinen E/A-Ziels in UMDF.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.9 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |