IPnpCallback::OnQueryRemove-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. 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 OnQueryRemove Methode benachrichtigt einen Treiber, bevor ein Gerät von einem Computer entfernt wird.
Syntax
HRESULT OnQueryRemove(
[in] IWDFDevice *pWdfDevice
);
Parameter
[in] pWdfDevice
Ein Zeiger auf die IWDFDevice Schnittstelle für das Geräteobjekt des Geräts, das entfernt wird.
Rückgabewert
Wenn der Treiber feststellt, dass das Gerät angehalten und entfernt werden kann, muss die OnQueryRemove- Rückrufmethode S_OK oder einen anderen Statuscode zurückgeben, für den SUCCEEDED(Status) TRUEist. Andernfalls muss ein Statuscode zurückgegeben werden, für den ERFOLGREICH(Status) FALSE-ist. HRESULT-Fehlercodes werden in Winerror.h definiert. Geben Sie HRESULT_FROM_NT(STATUS_NOT_SUPPORTED) nicht zurück.
Diese Methode muss das HRESULT_FROM_NT Makro verwenden, um einen bestimmten HRESULT-Wert zurückzugeben, um den Status an einen Kernelmodusclient zurückzugeben. Weitere Informationen finden Sie unter Unterstützen von Kernelmodusclients.
Bemerkungen
Ein Treiber registriert die IPnpCallback- Schnittstelle, wenn die IWDFDriver::CreateDevice-Methode zum Erstellen eines Geräteobjekts aufgerufen wird.
Das Framework synchronisiert die OnQueryRemove Rückruffunktion nicht mit anderen PnP- und Power Management-Rückruffunktionen.
Weitere Informationen zur OnQueryRemove- Rückrufmethode finden Sie unter Ein Benutzer hebt ein Gerätab.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | wudfddi.h (include Wudfddi.h) |