NetDeviceStoreResetDiagnostics function (netadaptercx.h)

Article
02/22/2024

The NetDeviceStoreResetDiagnostics function stores client driver collected reset diagnostics into the NetAdapterCx framework.

Syntax

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

Parameters

[_In_] Device

The WDFDEVICE object the client driver previously created with a call to WdfDeviceCreate.

[_In_] ResetDiagnosticsSize

The size in bytes of the ResetDiagnosticsBuffer. The maximum size of reset diagnostics the framework accepts is 1 MB.

[_In_reads_bytes_(ResetDiagnosticsSize)] ResetDiagnosticsBuffer

A pointer to the data buffer that holds the reset diagnostics data. The data buffer can come from either paged or non-paged pool.

Return value

None

Remarks

The only valid scenario to invoke the NetDeviceStoreResetDiagnostics function is in a client driver's EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS callback. The client driver must call NetDeviceStoreResetDiagnostics at PASSIVE_LEVEL

To learn how to correctly use the NetDeviceStoreResetDiagnostics function, see Implement EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS.

Requirements

Requirement	Value
Minimum supported client	Windows 11
Minimum supported server	Windows Server 2022
Header	netadaptercx.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL