Skip to content

Latest commit

 

History

History
100 lines (73 loc) · 3.19 KB

nc-dot11wificxintf-miniport_wdi_adapter_hang_diagnose.md

File metadata and controls

100 lines (73 loc) · 3.19 KB
UID tech.root title ms.date ms.topic targetos description req.assembly req.construct-type req.ddi-compliance req.dll req.header req.idl req.include-header req.irql req.kmdf-ver req.lib req.max-support req.namespace req.redist req.target-min-winverclnt req.target-min-winversvr req.target-type req.type-library req.umdf-ver req.unicode-ansi topic_type api_type api_location api_name f1_keywords dev_langs
NC:dot11wificxintf.MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE
netvista
MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE (dot11wificxintf.h)
10/02/2021
language-reference
Windows
Microsoft reserves the MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE callback function for internal use only. Don't use this callback function in your code.
function
dot11wificxintf.h
Windows 11
Windows Server 2022
apiref
LibDef
dot11wificxintf.h
MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE
MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE
dot11wificxintf/MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE
c++

-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

-param 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.

-param DiagnoseLevel

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

-param BufferSize

[in] The size of FirmwareBlob, in bytes.

-param FirmwareBlob

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

-param pOutputSize

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

-returns

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