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 没有足够的额度来取消最大成本帧的排队,则应发出 NdisWdiTxSendPauseIndication 而不是 NdisWdiTxDequeueIndication。
TxMgr 可能会返回超出帧数、帧成本或量子限制的 NET_BUFFER_LIST 列表。 仅当帧在发送完成后重新排队/重播,状态为“已推迟”且序列号相同时,才会发生这种情况,这表示它们最初是作为单个 A-MSDU 的一部分传输的。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 |
最低受支持的服务器 | Windows Server 2016 |
目标平台 | Windows |
标头 | dot11wdi.h |