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. 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 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 status Code zurückgeben, für den SUCCEEDED(status) true entspricht. Andernfalls muss ein status Code zurückgegeben werden, für den SUCCEEDED(status) gleich FALSE ist. HRESULT-Fehlercodes werden in Winerror.h definiert. Geben Sie HRESULT_FROM_NT(STATUS_NOT_SUPPORTED) nicht zurück.

Diese Methode muss das makro HRESULT_FROM_NT verwenden, um einen bestimmten HRESULT-Wert zurückzugeben, um status an einen Kernelmodusclient zurückzugeben. Weitere Informationen finden Sie unter Unterstützen von Kernelmodusclients.

Hinweise

Ein Treiber registriert die IPnpCallback-Schnittstelle , wenn er die IWDFDriver::CreateDevice-Methode aufruft , um ein Geräteobjekt zu erstellen.

Das Framework synchronisiert die Rückruffunktion OnQueryRemove nicht mit anderen PnP- und Power Management-Rückruffunktionen.

Weitere Informationen zur OnQueryRemove-Rückrufmethode finden Sie unter Ein Benutzer entfernt ein Gerät.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	wudfddi.h (include Wudfddi.h)

Weitere Informationen

IPnpCallback

IWDFDevice

IWDFDriver::CreateDevice