IWDTFPNPActions2::EDTTryStopDevice-Methode (wdtfpnpaction.h)

Artikel
02/29/2024

Versucht, ein IRP_MN_STOP_DEVICE-Ereignis an das Zielgerät zu senden.

Syntax

HRESULT EDTTryStopDevice(
  [out, retval] VARIANT_BOOL *pbSuccess
);

Parameter

[out, retval] pbSuccess

True, wenn der Vorgang erfolgreich ist; Andernfalls false.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Hinweis Die IWDTFEnhancedDeviceTestSupportAction2::Enable-Methode muss für das Zielgerät aufgerufen werden, bevor diese Methode aufgerufen wird.

EDTTryStopDevice versucht, einen PnP-Ressourcenausgleich (z. B. IRP_MN_STOP_DEVICE) auf dem Zielgerätestapel auszulösen. Die Stop-IRP ist nicht garantiert. Bei anderen Treibern im Stapel kann das IRP_MN_QUERY_STOP_DEVICE-Ereignis fehlschlagen, das dem Stopp-IRP vorangestellt ist (was zu einem IRP_MN_CANCEL_STOP_DEVICE-Ereignis führt). Außerdem kann das System optimieren, wenn es erkennt, dass das Zielgerät keine Hardwareressourcen (z. B. eine USB-Maus) verwendet, und stattdessen eine CancelStop-IRP sendet.

Wenn Ihr Gerät keine Hardwareressourcen verbraucht, Sie aber trotzdem versuchen möchten, zu testen, wie die Treiber und Anwendungen den Ausgleich der PnP-Ressourcen verarbeiten, können Sie stattdessen die EDTTryStopDevice-Methode auf einem übergeordneten Gerät, einem Großelternteil usw. ausführen, das Hardwareressourcen verbraucht. Wenn Ihr Gerät beispielsweise eine USB-Maus ist, können Sie stattdessen EDTTryStopDevice auf dem übergeordneten USB-Controller ausführen.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	wdtfpnpaction.h

Freigeben über