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