Edit

EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS callback function (netadaptercx.h)

  • Article

Implement this optional callback to collect diagnostics from a failed hardware device and report it to the NetAdapterCx framework during the device reset and recovery process.

Syntax

EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS EvtNetDeviceCollectResetDiagnostics;

void EvtNetDeviceCollectResetDiagnostics(
  [_In_] WDFDEVICE Device
)
{...}

Parameters

[_In_] Device

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

Return value

None

Remarks

If provided, the NetAdapterCx framework invokes the EVT_NET_DEVICE_COLLECT_RESET_DIAGNOSTICS callback to collect reset diagnostics during the reset and recovery process. The framework always invokes this callback at PASSIVE_LEVEL.

The EvtNetDeviceCollectResetDiagnostics field of the NET_DEVICE_RESET_CAPABILITIES data structure refers to this callback.

To learn how to correctly implement this callback and for more information about the framework's synchronization guarantee, 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

See also

Recovering an unresponsive NIC with NetAdapterCx PLDR

WdfDeviceCreate

NET_DEVICE_RESET_CAPABILITIES