EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS回调函数 (netadaptercx.h)

实现此可选回调以从故障硬件设备收集诊断,并在设备重置和恢复过程中将其报告给 NetAdapterCx 框架。

语法

EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS EvtNetDeviceCollectResetDiagnostics;

void EvtNetDeviceCollectResetDiagnostics(
  [_In_] WDFDEVICE Device
)
{...}

参数

[_In_] Device

客户端驱动程序先前通过调用 WdfDeviceCreate 获取的 WDFDEVICE 对象。

返回值

备注

如果提供,NetAdapterCx 框架会调用EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS回调,以在重置和恢复过程中收集重置诊断。 框架始终在 PASSIVE_LEVEL 调用此回调。

NET_DEVICE_RESET_CAPABILITIES数据结构的 EvtNetDeviceCollectResetDiagnostics 字段引用此回调。

若要了解如何正确实现此回调以及有关框架同步保证的详细信息,请参阅 实现 EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS

要求

要求
最低受支持的客户端 Windows 11
最低受支持的服务器 Windows Server 2022
最低 UMDF 版本 2.33
标头 netadaptercx.h (包括 netadaptercx.h)
IRQL PASSIVE_LEVEL

另请参阅

使用 NetAdapterCx PLDR 恢复无响应的 NIC

WdfDeviceCreate

NET_DEVICE_RESET_CAPABILITIES