MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE回调函数 (dot11wificxintf.h)

重要

本主题是 WiFiCx 驱动程序模型的一部分。 WiFiCx 是 Windows 11 中发布的 Wi-Fi 驱动程序模型。 建议使用 WiFiCx 来利用最新功能。 前面的 Wi-Fi 驱动程序模型 WDI 处于维护模式,仅接收高优先级修补程序。

MiniportWdiAdapterHangDiagnose 处理程序函数用于收集硬件控制寄存器状态和(可选)完整固件状态。

这是 NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS内的 WDI 微型端口处理程序。

注意

必须使用 MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE 类型声明函数。

语法

MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE MiniportWdiAdapterHangDiagnose;

NDIS_STATUS MiniportWdiAdapterHangDiagnose(
  NDIS_HANDLE MiniportDriverContext,
  eDiagnoseLevel DiagnoseLevel,
  UINT32 BufferSize,
  UINT8 *FirmwareBlob,
  UINT32 *pOutputSize
)
{...}

参数

MiniportDriverContext

[in]驱动程序分配的上下文区域的句柄,驱动程序在其中维护状态和配置信息。 微型端口驱动程序将此上下文区域传递给 NdisMRegisterWdiMiniportDriver 函数。

DiagnoseLevel

[in]诊断级别,如 eDiagnoseLevel 枚举中定义。 默认级别为 DiagnoseLevelHardwareRegisters,输出缓冲区中最大值为 1KB。

BufferSize

[in] FirmwareBlob 的大小(以字节为单位)。

FirmwareBlob

[out]指向缓冲区的指针,该缓冲区将包含硬件控制注册表状态以及(可选)完整固件状态。

pOutputSize

[out]指向写入 FirmwareBlob 的字节数的指针。

返回值

返回值将被忽略。

注解

默认诊断级别为 DiagnoseLevelHardwareRegisters,输出缓冲区中最大为 1KB。

要求

要求
最低受支持的客户端 Windows 11
最低受支持的服务器 Windows Server 2022
标头 dot11wificxintf.h

另请参阅

WDI 挂起检测和恢复

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

eDiagnoseLevel

NdisMRegisterWdiMiniportDriver