IWDTFPNPAction2::EDTTryStopDeviceRequestNewResources 方法 (wdtfpnpaction.h)

尝试将IRP_MN_STOP_DEVICE事件发送到目标设备,并将新资源分配给目标设备。

语法

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

参数

[out, retval] pbSuccess

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

返回值

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

注解

注意 在调用此方法之前,必须为目标设备调用 IWDTFEnhancedDeviceTestSupportAction2::Enable 方法。
 
EDTTryStopDevice 方法类似, EDTryStopDeviceRequestNewResources 尝试触发 PnP 资源再平衡 (例如目标设备堆栈上的IRP_MN_STOP_DEVICE) ,此外,该方法尝试将设备强制到一组新的硬件资源上。

无法保证停止 IRP。 堆栈上的其他驱动程序可能会使停止 IRP (之前的 IRP_MN_QUERY_STOP_DEVICE 事件失败,从而导致IRP_MN_CANCEL_STOP_DEVICE) 。 此外,如果系统检测到目标设备不使用硬件资源 (例如 USB 鼠标) 并改为发送 CancelStop IRP,则系统可能会进行优化。

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

要求

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

另请参阅

IWDTFPNPAction2