NDIS_WDI_PEER_CREATE_IND callback function

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(
  NDIS_HANDLE NdisMiniportDataPathHandle,
  WDI_PORT_ID PortId,
  WDI_PEER_ID PeerId,
  WDI_MAC_ADDRESS PeerAddr
)
{...}

Parameters

NdisMiniportDataPathHandle

The NdisMiniportDataPathHandle passed to IHV miniport in MiniportWdiTalTxRxInitialize.

PortId

The port ID.

PeerId

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

PeerAddr

The peer MAC address.

Return Value

This callback function does not return a value.

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

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

See Also

NDIS_WDI_DATA_API

WDI general datapath interfaces

WDI_MAC_ADDRESS

WDI_PEER_ID

WDI_PORT_ID