IWDTFPNPAction2::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_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.

 

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

Das Stop IRP ist nicht garantiert. Andere Treiber im Stapel können das IRP_MN_QUERY_STOP_DEVICE-Ereignis fehlschlagen, das vor dem Stop IRP steht (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 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 EDTTryStopDeviceReviceRequestNewResources 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 diese Methode stattdessen auf dem übergeordneten USB-Controller ausführen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP Professional
mindestens unterstützte Server-	Windows Server 2008
Zielplattform-	Desktop
Header-	wdtfpnpaction.h

Siehe auch

IWDTFPNPAction2