IWDTFPNPActions2::EDTTryStopDeviceRequestNewResources-Methode (wdtfpnpaction.h)

Versucht, ein IRP_MN_STOP_DEVICE-Ereignis an das Zielgerät zu senden und dem Zielgerät neue Ressourcen zuzuweisen.

Syntax

HRESULT EDTTryStopDeviceRequestNewResources(
  [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.

 

Ähnlich wie die EDTTryStopDevice-Methode versucht EDTTryStopDeviceRequestNewResources , eine PnP-Ressourcenrebalance (z. B. IRP_MN_STOP_DEVICE) auf dem Zielgerätestapel auszulösen, wobei die Methode versucht, das Gerät auf eine neue Gruppe von Hardwareressourcen zu erzwingen.

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 IRP_MN_CANCEL_STOP_DEVICE 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 behandeln, können Sie stattdessen EDTTryStopDeviceRequestNewResources 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 diese Methode stattdessen auf dem übergeordneten USB-Controller ausführen.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	wdtfpnpaction.h