netdeviceRequestReset 函数 (netadaptercx.h)
NetDeviceRequestReset 函数触发 NetAdapterCx 框架执行平台级设备重置操作，以恢复无响应的 NIC 设备。
语法
void NetDeviceRequestReset(
[_In_] WDFDEVICE Device
);
参数
[_In_] Device
以前通过调用 WdfDeviceCreate 创建的客户端驱动程序的 WDFDEVICE 对象。
返回值
无
备注
客户端驱动程序在检测到设备故障时调用 NetDeviceRequestReset 。 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 |