MINIPORT_WDI_TX_DATA_SEND回调函数（dot11wdi.h）

项目
02/06/2025

重要

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

MiniportWdiTxDataSend 处理程序函数指定要从中传输的 RA-TID 或端口队列。它在作系统、恢复指示或工作项的 TX 线程上下文中发出。

这是 NDIS_MINIPORT_WDI_DATA_HANDLERS内的 WDI 微型端口处理程序。

注意必须使用 MINIPORT_WDI_TX_DATA_SEND 类型声明函数。有关详细信息，请参阅以下示例部分。

语法

MINIPORT_WDI_TX_DATA_SEND MiniportWdiTxDataSend;

void MiniportWdiTxDataSend(
  [in] TAL_TXRX_HANDLE MiniportTalTxRxContext,
  [in] WDI_PORT_ID PortId,
  [in] WDI_PEER_ID PeerId,
  [in] WDI_EXTENDED_TID ExTid,
  [in] UINT16 NumQueueFrames,
  [in] UINT32 NumActiveFrames,
  [in] BOOLEAN bRobustnessFlag
)
{...}

参数

[in] MiniportTalTxRxContext

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

[in] PortId

端口 ID。

[in] PeerId

对等 ID。

[in] ExTid

扩展 TID。

[in] NumQueueFrames

队列长度（以帧为单位）。

[in] NumActiveFrames

作中的帧总数（可计划）队列。

[in] bRobustnessFlag

可靠性标志。如果可靠度标志设置为 TRUE，则 NIC 通过积极降低使用 CTS 和/或其他机制对帧使用的 TX 数据速率，确保少量重试中的可靠传递。

返回值

没有

言论

在端口队列模式下，WDI_PEER_ID 和 WDI_EXTENDED_TID 设置为通配符。在发送请求的上下文中，TxEngine 发出 NdisWdiTxDequeueIndication 从 FIFO RA-TID 队列获取多个帧的所有权，并将其传输到目标。如果无法取消任何帧的排队，则 TxEngine 在同一上下文中 NdisWdiTxSendPauseIndication，而不是 NdisWdiTxDequeueIndication。

TxEngine 必须发出传输完成，并发送完整指示，以将它取消排队的任何帧的所有权返回到 TxMgr。如果传输完成包含失败代码，则 TxEngine 不得发出发送完成。

例子

若要定义 MiniportWdiTxDataSend 函数，必须先提供一个函数声明，用于标识要定义的函数的类型。 Windows 为驱动程序提供了一组函数类型。使用函数类型声明函数有助于驱动程序代码分析、静态驱动程序验证程序（SDV）和其他验证工具查找错误，这是为 Windows作系统编写驱动程序的要求。

例如，若要定义名为“MyTxDataSend”的 MiniportWdiTxDataSend 函数，请使用 MINIPORT_WDI_TX_DATA_SEND 类型，如以下代码示例所示：

MINIPORT_WDI_TX_DATA_SEND MyTxDataSend;

然后，按如下所示实现函数：

_Use_decl_annotations_
VOID
 MyTxDataSend(
    TAL_TXRX_HANDLE MiniportTalTxRxContext,
    WDI_PORT_ID PortId,
    WDI_PEER_ID PeerId,
    WDI_EXTENDED_TID ExTid,
    UINT16 NumQueueFrames,
    UINT32 NumActiveFrames,
    BOOLEAN bRobustnessFlag
    )
  {...}

MINIPORT_WDI_TX_DATA_SEND 函数类型在 dot11wdi.h 头文件中定义。若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations 批注可确保使用应用于头文件中 MINIPORT_WDI_TX_DATA_SEND 函数类型的批注。有关函数声明要求的详细信息，请参阅使用 NDIS 驱动程序的函数角色类型声明函数。

有关 Use_decl_annotations的信息，请参阅批注函数行为。