NetDeviceStoreResetDiagnostics function (netadaptercx.h)
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 |
| Minimum UMDF version | 2.33 |
| Header | netadaptercx.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |