IWDTFPNPAction2::EDTryStopDevice 方法(wdtfpnpaction.h)

尝试将IRP_MN_STOP_DEVICE事件发送到目标设备。

语法

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

参数

[out, retval] pbSuccess

如果作成功,则为 True;否则为 false。

返回值

如果此方法成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码。

言论

注意 调用此方法之前,必须为目标设备调用 IWDTFEnhancedDeviceTestSupportAction2::Enable 方法。
 
EDTryStopDevice 尝试在目标设备堆栈上触发 PnP 资源重新均衡(例如IRP_MN_STOP_DEVICE)。 不保证停止 IRP。 堆栈上的其他驱动程序可能会失败在停止 IRP 之前的IRP_MN_QUERY_STOP_DEVICE事件(导致IRP_MN_CANCEL_STOP_DEVICE事件)。 此外,如果系统检测到目标设备不使用硬件资源(例如 USB 鼠标),并改为发送 CancelStop IRP,则系统可能会进行优化。

如果设备不使用硬件资源,但仍希望尝试测试驱动程序和应用程序如何处理 PnP 资源重新均衡,则可以改为在父设备、祖父母等上运行 EDTryStopDevice 方法,从而消耗硬件资源。 例如,如果你的设备是 USB 鼠标,则可以改为在父 USB 控制器上运行 EDTryStopDevice

要求

要求 价值
最低支持的客户端 Windows XP Professional
支持的最低服务器 Windows Server 2008
目标平台 桌面
标头 wdtfpnpaction.h

另请参阅

IWDTFPNPAction2