IWDTFPNPActions2::EDTryStopDeviceRequestNewResources 方法 (wdtfpnpaction.h)

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

语法

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

参数

[out, retval] pbSuccess

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

返回值

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

言论

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

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

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

要求

要求 价值
目标平台 桌面
标头 wdtfpnpaction.h