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 方法。
无法保证停止 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 |