IPnpCallback::OnQueryStop-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 OnQueryStop- Methode benachrichtigt einen Treiber, bevor ein Gerät beendet wird.
HRESULT OnQueryStop(
[in] IWDFDevice *pWdfDevice
);
[in] pWdfDevice
Ein Zeiger auf die IWDFDevice- Schnittstelle für das Geräteobjekt des Geräts, das beendet wird.
Wenn der Treiber feststellt, dass das Gerät beendet werden kann, muss die OnQueryStop- 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 SUCCEEDED(Status) FALSE-entspricht. 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.
Ein Treiber registriert die IPnpCallback- Schnittstelle, wenn die IWDFDriver::CreateDevice-Methode zum Erstellen eines Geräteobjekts aufgerufen wird.
Das Framework synchronisiert die OnQueryStop- Rückruffunktion nicht mit anderen PnP- und Power Management-Rückruffunktionen.
OnQueryStop- wird in framework-Versionen 1.7 und früher nicht aufgerufen.
Weitere Informationen zur OnQueryStop- Rückrufmethode finden Sie unter The PnP Manager Redistributes System Resources.
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | wudfddi.h (include Wudfddi.h) |