NDIS_WDI_TX_RELEASE_FRAMES_IND回调函数 (dot11wdi.h)

重要

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

当传输暂停时,NdisWdiTxReleaseFrameIndication 回调函数将释放排队到给定对等-TID 组合的帧的指定数量或总成本。 如果未暂停指定的队列,则不会释放任何NET_BUFFER_LISTs。

这是 NDIS_WDI_DATA_API内部的回调。

语法

NDIS_WDI_TX_RELEASE_FRAMES_IND NdisWdiTxReleaseFramesInd;

void NdisWdiTxReleaseFramesInd(
  [in]  NDIS_HANDLE NdisMiniportDataPathHandle,
  [in]  WDI_PORT_ID PortId,
  [in]  WDI_PEER_ID PeerId,
  [in]  UINT32 ExTidBitmask,
  [in]  UINT8 MaxNumFrames,
  [in]  UINT16 Credit,
  [out] PNET_BUFFER_LIST *ppNBL
)
{...}

参数

[in] NdisMiniportDataPathHandle

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

[in] PortId

端口 ID。 必须是非通配符值。

[in] PeerId

对等 ID。 必须是非通配符值。

[in] ExTidBitmask

扩展的 TID 位掩码。

[in] MaxNumFrames

最大帧计数。 如果将 MaxNumFrames 设置为 WDI_TX_MAX_FRAME_COUNT_INVALID (0xFF) ,则忽略它。

[in] Credit

信用。 如果设置为WDI_TX_CREDIT_INVALID (0xFFFF) ,则忽略额度

[out] ppNBL

指向指向释放帧 NET_BUFFER_LIST 链的指针的指针。

返回值

备注

如果某个指定的队列暂停 WDI_TX_PAUSE_REASON_PS,则 TAL/Target 在收到该队列的 MiniportWdiTxTalQueueInOrder 指示之前不会发出此指示。

仅当 TargetPriorityQueueing 为 false 时,才允许使用此指示。

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

要求

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

另请参阅

MiniportWdiTxTalQueueInOrder

NDIS_WDI_DATA_API

NET_BUFFER_LIST

WDI_PEER_ID

WDI_PORT_ID

WDI_TXRX_CAPABILITIES

WDI_TX_PAUSE_REASON