NetDeviceRequestReset 函数 （netadaptercx.h）
NetDeviceRequestReset 函数触发 NetAdapterCx 框架来执行恢复无响应 NIC 设备的平台级设备重置作。
语法
void NetDeviceRequestReset(
[_In_] WDFDEVICE Device
);
参数
[_In_] Device
以前通过调用 WdfDeviceCreate创建的客户端驱动程序的 WDFDEVICE 对象。
返回值
没有
言论
客户端驱动程序在检测到设备故障时调用 NetDeviceRequestRequestReset。 NetDeviceRequestReset 立即返回到客户端驱动程序。 驱动程序只能在 PASSIVE_LEVEL 调用 NetDeviceRequestReset。
NetDeviceRequestReset 是非阻止的，并立即返回到客户端驱动程序。 客户端驱动程序应取消访问当前失败设备的任何正在进行的作业。
建议客户端驱动程序设置 NET_DEVICE_RESET_CAPABILITIES 结构，以在设备重置和恢复过程中收集有意义的重置诊断。 有关如何收集重置诊断的详细信息，请参阅 注册可选的诊断收集回调。
NetDeviceRequestReset 仅适用于基于 PCIe 的 NIC 设备。 对于基于 USB 的 NIC 设备，请遵循 如何从 USB 管道错误中恢复的过程。
如果设备遇到不可恢复的硬件或软件错误，客户端驱动程序可以使用 WdfDeviceSetFailed 函数。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 11 |
| 支持的最低服务器 | Windows Server 2022 |
| 最低 UMDF 版本 | 2.33 |
| 标头 | netadaptercx.h （包括 netadaptercx.h） |
| IRQL | PASSIVE_LEVEL |
另请参阅
使用 NetAdapterCx PLDR 恢复无响应 NIC