IWDTFPNPAction2::EDTTryStopDevice-Methode (wdtfpnpaction.h)

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. Das Beenden von IRP ist nicht garantiert. Bei anderen Treibern im Stapel kann das IRP_MN_QUERY_STOP_DEVICE-Ereignis fehlschlagen, das dem Beenden von IRP vorangeht (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 die PnP-Ressourcenbalance 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
Unterstützte Mindestversion (Client)	Windows XP Professional
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Desktop
Kopfzeile	wdtfpnpaction.h

Weitere Informationen

IWDTFPNPAction2