NDIS_WDI_PEER_CREATE_IND callback function (dot11wdi.h)

Article
02/22/2024

Important

This topic is part of the WDI driver model released in Windows 10. The WDI driver model is in maintenance mode and will only receive high priority fixes. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features.

The NdisWdiPeerCreateIndication callback function specifies a peer ID to associate with a peer MAC address.

This is a callback inside NDIS_WDI_DATA_API.

Syntax

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
)
{...}

Parameters

[in] NdisMiniportDataPathHandle

The NdisMiniportDataPathHandle passed to IHV miniport in MiniportWdiTalTxRxInitialize.

[in] PortId

The port ID.

[in] PeerId

The peer ID. This is used to identify the peer in subsequent commands and indications.

[in] PeerAddr

The peer MAC address.

Return value

None

Remarks

This must be received and processed prior to exchanging frames with the peer.

A port operating in AP or Wi-Fi Direct GO mode may simultaneously have more than one peer (clients). When a port is operating in AP or Wi-Fi Direct GO mode, the IHV miniport creates a 'peer' for group addressed traffic (by passing a broadcast MAC address). All multicast and broadcast traffic for this port is associated with this peer. In port queuing mode, the creation of the group peer by the IHV miniport is not required as Tx frame classification does not occur in this mode.

A port operating in any mode may create a group peer.

To facilitate TDLS implementation in the IHV component, a port operating in STA or Wi-Fi Direct client mode may simultaneously have more than one peer. If a TX frame's destination MAC address matches is associated with a non-AP/GO peer ID, the TxMgr queues the frame with a TID queue associated with that non-AP/GO peer (if WDI is operating in PeerTID queuing mode).

In peer queuing mode, a peer is created with all TIDs paused with WDI_TX_PAUSE_REASON_PEER_CREATE.

Requirements

Requirement	Value
Minimum supported client	Windows 10
Minimum supported server	Windows Server 2016
Target Platform	Windows
Header	dot11wdi.h