NDIS_WDI_TX_DEQUEUE_IND回调函数 (dot11wdi.h)

重要

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

IHV 微型端口在 MiniportWdiTxDataSend 或 MiniportWdiTxTalSend 的上下文中调用 NdisWdiTxDequeueIndication 回调函数,以将帧从 WDI 取消到 IHV 微型端口的排队。

这是 NDIS_WDI_DATA_API内部的回调。

语法

NDIS_WDI_TX_DEQUEUE_IND NdisWdiTxDequeueInd;

void NdisWdiTxDequeueInd(
  [in]  NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]  UINT32 Quantum,
  [in]  UINT8 MaxNumFrames,
  [in]  UINT16 Credit,
  [out] PNET_BUFFER_LIST *ppNBL
)
{...}

参数

[in] NdisMiniportDataPathHandle

传递到 MiniportWdiTalTxRxInitialize 中的 IHV 微型端口的 NdisMiniportDataPathHandle。

[in] Quantum

量子。 有关详细信息,请参阅 WDITX 路径中的主机 - 目标 TX 传输计划部分。

[in] MaxNumFrames

最大帧计数。

[in] Credit

信用值。 有关详细信息,请参阅 WDI TX 路径中的目标额度方案和暂停/恢复机制部分。

[out] ppNBL

指向由 WDI 取消排队 的NET_BUFFER_LIST 链的指针的指针。

返回值

备注

参数的子集可能不适用于设备。 例如,最大帧计数可能不适用于存储和转发设备, (基于消息的总线接口) 。

在这些情况下,TxMgr 将忽略以下参数。

  • 如果设置为WDI_TX_QUANTUM_INVALID (0xFFFFFFFF)
  • MaxNumFrames (如果设置为 WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF)
  • 如果设置为WDI_TX_CREDIT_INVALID (0xFFFF)
TAL 应尽可能提供准确的参数,以保证公平性并避免压倒性的 TIL/目标资源。

如果 TAL 没有足够的额度来取消最大成本帧的排队,则应发出 NdisWdiTxSendPauseIndication 而不是 NdisWdiTxDequeueIndication

TxMgr 可能会返回超出帧数、帧成本或量子限制的 NET_BUFFER_LIST 列表。 仅当帧在发送完成后重新排队/重播,状态为“已推迟”且序列号相同时,才会发生这种情况,这表示它们最初是作为单个 A-MSDU 的一部分传输的。

要求

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

另请参阅

NDIS_WDI_DATA_API

NET_BUFFER_LIST

NdisWdiTxDequeueIndication

NdisWdiTxSendPauseIndication

WDI TX 路径