NET_DEVICE_RESET_CAPABILITIES_INIT function (netadaptercx.h)

The NET_DEVICE_RESET_CAPABILITIES_INIT function initializes a NET_DEVICE_RESET_CAPABILITIES structure.

Syntax

void NET_DEVICE_RESET_CAPABILITIES_INIT(
  [_Out_] NET_DEVICE_RESET_CAPABILITIES            *ResetCapabilities,
  [_In_]  GUID                                     ResetDiagnosticsGuid,
  [_In_]  PFN_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS EvtNetDeviceCollectResetDiagnostics
);

Parameters

[_Out_] ResetCapabilities

A pointer to a driver-allocated NET_DEVICE_RESET_CAPABILITIES structure.

[_In_] ResetDiagnosticsGuid

A client driver specified global unique identifier (GUID). Developers can use this identifier to retrieve reset diagnostics. The client driver collects the reset diagnostics as secondary data in the full kernel dump captured in the process of device reset and recovery.

[_In_] EvtNetDeviceCollectResetDiagnostics

A pointer to the client driver's implementation of the EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS callback that collects device-specific reset diagnostics from a hardware device.

Return value

None

Remarks

A client driver typically calls NET_DEVICE_RESET_CAPABILITIES_INIT in its EVT_WDF_DRIVER_DEVICE_ADD callback.

This function zeros out the NET_DEVICE_RESET_CAPABILITIES structure and fills in its Size member. Then it sets the ResetDiagnosticsGuid member and EvtNetDeviceCollectResetDiagnostics member with the corresponding input parameters.

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

See also

Recovering an unresponsive NIC with NetAdapterCx PLDR

EVT_WDF_DRIVER_DEVICE_ADD

NET_DEVICE_RESET_CAPABILITIES

EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS