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