NET_DEVICE_RESET_CAPABILITIES structure (netadaptercx.h)

The NET_DEVICE_RESET_CAPABILITIES structure describes a client driver's capabilities for collecting diagnostics during the device reset and recovery process.

Syntax

typedef struct _NET_DEVICE_RESET_CAPABILITIES {
  ULONG                                    Size;
  GUID                                     ResetDiagnosticsGuid;
  PFN_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS EvtNetDeviceCollectResetDiagnostics;
} NET_DEVICE_RESET_CAPABILITIES;

Members

Size

The size of this structure, in bytes.

ResetDiagnosticsGuid

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

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.

Remarks

Client drivers initialize and register this structure in their EVT_WDF_DRIVER_DEVICE_ADD callback function.

Call NET_DEVICE_RESET_CAPABILITIES_INIT to initialize this structure.

Call NetDeviceInitSetResetCapabilities to register this structure to the NetAdapterCx framework.

For more information, see Register NET_DEVICE_RESET_CAPABILITIES.

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)

See also

Recovering an unresponsive NIC with NetAdapterCx PLDR

EVT_WDF_DRIVER_DEVICE_ADD

EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS

NET_DEVICE_RESET_CAPABILITIES_INIT

NetDeviceInitSetResetCapabilities