NDIS_WDI_PEER_CREATE_IND回调函数（dot11wdi.h）

项目
02/06/2025

重要

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

NdisWdiPeerCreateIndication 回调函数指定要与对等 MAC 地址关联的对等 ID。

这是 NDIS_WDI_DATA_API内的回调。

语法

NDIS_WDI_PEER_CREATE_IND NdisWdiPeerCreateInd;

void NdisWdiPeerCreateInd(
  [in] NDIS_HANDLE NdisMiniportDataPathHandle,
  [in] WDI_PORT_ID PortId,
  [in] WDI_PEER_ID PeerId,
  [in] WDI_MAC_ADDRESS PeerAddr
)
{...}

参数

[in] NdisMiniportDataPathHandle

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

[in] PortId

端口 ID。

[in] PeerId

对等 ID。这用于标识后续命令和指示中的对等方。

[in] PeerAddr

对等 MAC 地址。

返回值

没有

言论

在与对等方交换帧之前，必须接收和处理此信息。

在 AP 或 Wi-Fi Direct GO 模式下运行的端口可能同时具有多个对等方（客户端）。当端口在 AP 或 Wi-Fi Direct GO 模式下运行时，IHV 微型端口会为组寻址流量创建“对等”（通过传递广播 MAC 地址）。此端口的所有多播和广播流量都与此对等方相关联。在端口队列模式下，不需要 IHV 微型端口创建组对等，因为 Tx 帧分类不会在此模式下发生。

在任何模式下运行的端口可能会创建组对等方。

为了方便 IHV 组件中的 TDLS 实现，在 STA 或 Wi-Fi Direct 客户端模式下运行的端口可能同时具有多个对等。如果 TX 帧的目标 MAC 地址与非 AP/GO 对等 ID 相关联，则 TxMgr 会将帧与该非 AP/GO 对等方关联的 TID 队列排队（如果 WDI 在 PeerTID 队列模式下运行）。

在对等队列模式下，将创建一个对等方，其中所有 TID 都暂停了 WDI_TX_PAUSE_REASON_PEER_CREATE。