通过

NetDeviceStoreResetDiagnostics 函数 （netadaptercx.h）

  • 项目

NetDeviceStoreResetDiagnostics 函数将客户端驱动程序收集的重置诊断存储在 NetAdapterCx 框架中。

语法

void NetDeviceStoreResetDiagnostics(
  [_In_]                                   WDFDEVICE   Device,
  [_In_]                                   SIZE_T      ResetDiagnosticsSize,
  [_In_reads_bytes_(ResetDiagnosticsSize)] const UINT8 *ResetDiagnosticsBuffer
);

参数

[_In_] Device

以前通过调用 WdfDeviceCreate创建的客户端驱动程序的 WDFDEVICE 对象。

[_In_] ResetDiagnosticsSize

ResetDiagnosticsBuffer的大小（以字节为单位）。 框架接受的最大重置诊断大小为 1 MB。

[_In_reads_bytes_(ResetDiagnosticsSize)] ResetDiagnosticsBuffer

指向保存重置诊断数据的数据缓冲区的指针。 数据缓冲区可以来自分页池或非分页池。

返回值

没有

言论

调用 NetDeviceStoreResetDiagnostics 函数的唯一有效方案是在客户端驱动程序的 EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS 回调中。 客户端驱动程序必须在 PASSIVE_LEVEL 调用 NetDeviceStoreResetDiagnostics

若要了解如何正确使用 NetDeviceStoreResetDiagnostics 函数，请参阅 实现 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

EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS