IWDTFPNPActions2::EDTTryStopDeviceFailRestart 方法 (wdtfpnpaction.h)
嘗試將IRP_MN_STOP_DEVICE事件傳送至目標裝置,然後失敗後續的裝置重新啟動。
語法
HRESULT EDTTryStopDeviceFailRestart(
[out, retval] VARIANT_BOOL *pbSuccess
);
參數
[out, retval] pbSuccess
如果作業成功,則為 True;否則為 false。
傳回值
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
注意 呼叫此方法之前,必須先呼叫目標裝置的 IWDTFEnhancedDeviceTestSupportAction2::Enable 方法。
不保證停止 IRP。 堆疊上的其他驅動程式可能會失敗IRP_MN_QUERY_STOP_DEVICE事件,在停止 IRP (之前導致IRP_MN_CANCEL_STOP_DEVICE) 。 此外,如果系統偵測到目標裝置未使用硬體資源, (例如USB滑鼠) 並改為傳送 CancelStop IRP,系統可能會進行優化。
如果您的裝置未取用硬體資源,但您仍想要嘗試測試驅動程式和應用程式如何處理失敗啟動的 PnP 資源重新平衡,您可以改為在父裝置、父系等上執行 EDTTryStopDeviceFailRestart 方法,以取用硬體資源。 例如,如果您的裝置是USB滑鼠,您可以改為在父USB控制器上執行此方法。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | wdtfpnpaction.h |