IWDTFPNPActions2::EDTTryStopDevice-Methode (wdtfpnpaction.h)

Artikel
02/07/2025

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_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Bemerkungen

Hinweis Die IWDTFEnhancedDeviceTestSupportAction2::Enable-Methode muss vor dem Aufrufen dieser Methode für das Zielgerät aufgerufen werden.

EDTTryStopDevice versucht, eine PnP-Ressourcenrebalance (z. B. IRP_MN_STOP_DEVICE) auf dem Zielgerätestapel auszulösen. Das Stop IRP ist nicht garantiert. Andere Treiber im Stapel können das IRP_MN_QUERY_STOP_DEVICE-Ereignis fehlschlagen, das dem Stop IRP vorausgeht (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 ein CancelStop-IRP sendet.

Wenn Ihr Gerät keine Hardwareressourcen verbraucht, Sie aber dennoch versuchen möchten, zu testen, wie die Treiber und Anwendungen die PnP-Ressource neu ausgleichen, können Sie stattdessen die EDTTryStopDevice Methode auf einem übergeordneten Gerät, den Großeltern usw. ausführen, was 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
Header-	wdtfpnpaction.h

Freigeben über