MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// dot11wdi.h

MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE MiniportWdiAdapterHangDiagnose;

NDIS_STATUS MiniportWdiAdapterHangDiagnose(
  [in]  NDIS_HANDLE MiniportDriverContext,
  [in]  eDiagnoseLevel DiagnoseLevel,
  [in]  UINT32 BufferSize,
  [out] UINT8 *FirmwareBlob,
  [out] UINT32 *pOutputSize
)
{...}
View the official Windows Driver Kit DDI reference
// dot11wificxintf.h

MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE MiniportWdiAdapterHangDiagnose;

NDIS_STATUS MiniportWdiAdapterHangDiagnose(
  NDIS_HANDLE MiniportDriverContext,
  eDiagnoseLevel DiagnoseLevel,
  UINT32 BufferSize,
  UINT8 *FirmwareBlob,
  UINT32 *pOutputSize
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nc-dot11wdi-miniport_wdi_adapter_hang_diagnose)

MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE callback function

Description

[!IMPORTANT] This topic is part of the WDI driver model released in Windows 10. The WDI driver model is in maintenance mode and will only receive high priority fixes. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features.

The MiniportWdiAdapterHangDiagnose handler function is used to collect hardware control register states and optionally full firmware state.

This is a WDI miniport handler inside NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

Note You must declare the function by using the MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE type. For more information, see the following Examples section.

Parameters

MiniportDriverContext [in]

The handle to a driver-allocated context area where the driver maintains state and configuration information. The miniport driver passed this context area to the NdisMRegisterWdiMiniportDriver function.

DiagnoseLevel [in]

The diagnose level, as defined in the eDiagnoseLevel enumeration. The default level is DiagnoseLevelHardwareRegisters, 1KB maximum in the output buffer.

BufferSize [in]

The size of FirmwareBlob, in bytes.

FirmwareBlob [out]

A pointer to the buffer that will contain the hardware control registry states, and optionally full firmware state.

pOutputSize [out]

A pointer to the number of bytes written to FirmwareBlob.

Return value

The return value is ignored.

Remarks

The default diagnose level is DiagnoseLevelHardwareRegisters, with 1KB maximum in the output buffer.

See also

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

WDI hang detection and recovery

eDiagnoseLevel


Windows Driver Kit DDI reference (nc-dot11wificxintf-miniport_wdi_adapter_hang_diagnose)

Description

[!IMPORTANT] This topic is part of the WiFiCx driver model. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features. The previous Wi-Fi driver model WDI is in maintenance mode and will only receive high priority fixes.

The MiniportWdiAdapterHangDiagnose handler function is used to collect hardware control register states and optionally full firmware state.

This is a WDI miniport handler inside NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS.

[!NOTE] You must declare the function by using the MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE type.

Parameters

MiniportDriverContext

[in] The handle to a driver-allocated context area where the driver maintains state and configuration information. The miniport driver passed this context area to the NdisMRegisterWdiMiniportDriver function.

DiagnoseLevel

[in] The diagnose level, as defined in the eDiagnoseLevel enumeration. The default level is DiagnoseLevelHardwareRegisters, 1KB maximum in the output buffer.

BufferSize

[in] The size of FirmwareBlob, in bytes.

FirmwareBlob

[out] A pointer to the buffer that will contain the hardware control registry states, and optionally full firmware state.

pOutputSize

[out] A pointer to the number of bytes written to FirmwareBlob.

Return value

The return value is ignored.

Remarks

The default diagnose level is DiagnoseLevelHardwareRegisters, with 1KB maximum in the output buffer.

See also

WDI hang detection and recovery

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

eDiagnoseLevel

NdisMRegisterWdiMiniportDriver