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 |