MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE回调函数 (dot11wdi.h)

  • 项目

重要

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

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

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

注意 必须使用 MINIPORT_WDI_ADAPTER_HANG_DIAGNOSE 类型声明函数。 有关详细信息，请参阅以下示例部分。
 

语法

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
)
{...}

参数

[in] MiniportDriverContext

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

[in] DiagnoseLevel

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

[in] BufferSize

FirmwareBlob 的大小（以字节为单位）。

[out] FirmwareBlob

指向缓冲区的指针，该缓冲区将包含硬件控制注册表状态以及（可选）完整固件状态。

[out] pOutputSize

指向写入 FirmwareBlob 的字节数的指针。

返回值

返回值将被忽略。

备注

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

要求

要求 值
最低受支持的客户端 Windows 10
最低受支持的服务器 Windows Server 2016
目标平台 Windows
标头 dot11wdi.h

另请参阅

NDIS_MINIPORT_DRIVER_WDI_CHARACTERISTICS

WDI 挂起检测和恢复

eDiagnoseLevel