共用方式為


IWDTFPNPActions2::EDTTryStopDevice 方法 (wdtfpnpaction.h)

嘗試將IRP_MN_STOP_DEVICE事件傳送至目標裝置。

語法

HRESULT EDTTryStopDevice(
  [out, retval] VARIANT_BOOL *pbSuccess
);

參數

[out, retval] pbSuccess

如果作業成功,則為 True;否則為 false。

傳回值

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

注意 呼叫此方法之前,必須先呼叫目標裝置的 IWDTFEnhancedDeviceTestSupportAction2::Enable 方法。
 
EDTTryStopDevice 嘗試觸發 PnP 資源重新平衡 (例如目標裝置堆疊上的IRP_MN_STOP_DEVICE) 。 不保證停止 IRP。 堆疊上的其他驅動程式可能會失敗IRP_MN_QUERY_STOP_DEVICE事件,該事件在停止 IRP (之前會導致IRP_MN_CANCEL_STOP_DEVICE事件) 。 此外,如果系統偵測到目標裝置未使用硬體資源, (例如USB滑鼠) 並改為傳送 CancelStop IRP,系統可能會進行優化。

如果您的裝置未取用硬體資源,但仍想要嘗試測試驅動程式和應用程式如何處理 PnP 資源重新平衡,您可以改為在父裝置、父代父系等上執行 EDTTryStopDevice 方法,以使用硬體資源。 例如,如果您的裝置是USB滑鼠,您可以改為在父USB控制器上執行 EDTTryStopDevice

規格需求

需求
目標平台 桌面
標頭 wdtfpnpaction.h