MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT回调函数 (dot11wdi.h)

重要

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

TxSuspectFrameListAbort 回调函数由 IHV 微型端口实现，以通知 TxEngine TxMgr 已识别出可疑挂起或等待完成相当长一段时间的帧。

语法

MINIPORT_WDI_TX_SUSPECT_FRAME_LIST_ABORT MiniportWdiTxSuspectFrameListAbort;

void MiniportWdiTxSuspectFrameListAbort(
  TAL_TXRX_HANDLE MiniportTalTxRxContext,
  UINT64 SuspectFrameContext,
  UINT16 NumSuspectFrames,
  PNET_BUFFER_LIST *SuspectFrameList
)
{...}

参数

MiniportTalTxRxContext

MiniportWdiTalTxRxInitialize 中的 IHV 微型端口返回的 TAL 设备句柄。

SuspectFrameContext

有关可疑帧的上下文信息。

NumSuspectFrames

可疑帧数。

SuspectFrameList

可疑帧的列表。 有关详细信息，请参见“备注”部分。

返回值

无

备注

通过设置 NDIS_MINIPORT_WDI_DATA_HANDLERS 结构的相应成员来注册此回调函数的实现。

这是一个可选的处理程序。 如果 IHV 微型端口未实现此回调的行为，则它不应在 NDIS_MINIPORT_WDI_DATA_HANDLERS 中设置函数指针，并且 WDI 不会调用此处理程序。 但是，如果未实现此回调的行为，则如果 IHV 微型端口使用 SuspectFrameList 记录 IHV 状态以进行诊断，则仍可能设置函数指针。

此回调函数通知 TxEngine TxMgr 已识别出可疑挂起或等待完成相当长一段时间的帧。 NBL 指针的 SuspectFrameList 数组（ 下一个 指针不适用）表示 TxMgr 请求提示完成的帧，即使这会导致帧无法通过无线传输也是如此。

TxEngine 可以通过从 TxSuspectFrameListAbort 的上下文中使用传递给处理程序的 SuspectFrameContext 调用 TxQuerySuspectFrameStatus 来检查 SuspectFrameList 数组中的 NBL 状态。 在 TxSuspectFrameAbort 期间，TxMgr 不会为 SuspectFrameList 中的任何 NBL 调用 TxTargetDescDeinit，也不会完成 NDIS 的帧。

如果 TxEngine 或固件不知道可疑帧或状态，则它不应为该可疑帧发出补全，因为这可能会导致系统损坏和/或双重完成。

如果检测到固件停止或损坏，应发出 NDIS_STATUS_WDI_INDICATION_FIRMWARE_STALLED 通知以尝试恢复。

要求

要求	值
Header	dot11wdi.h