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 |