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

另请参阅

使用 NetAdapterCx PLDR 恢复无响应的 NIC

WdfDeviceCreate

EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS