MINIPORT_WDI_TX_DATA_SEND回调函数 (dot11wdi.h)

项目
02/26/2024

重要

本主题是 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的信息，请参阅批注函数行为。