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
标头	netadaptercx.h (包括 netadaptercx.h)
IRQL	PASSIVE_LEVEL