NET_DEVICE_RESET_CAPABILITIES_INIT function (netadaptercx.h)

Article
02/22/2024

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
Header	netadaptercx.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL