NDIS_WDI_PEER_CREATE_IND Rückruffunktion (dot11wdi.h)

Wichtig

Dieses Thema ist Teil des WDI-Treibermodells, das in Windows 10 veröffentlicht wurde. Das WDI-Treibermodell befindet sich im Wartungsmodus und erhält nur Korrekturen mit hoher Priorität. WiFiCx ist das Wi-Fi Treibermodell, das in Windows 11 veröffentlicht wurde. Es wird empfohlen, wiFiCx zu verwenden, um die neuesten Features zu nutzen.

Die Rückruffunktion NdisWdiPeerCreateIndication gibt eine Peer-ID an, die einer Peer-MAC-Adresse zugeordnet werden soll.

Dies ist ein Rückruf innerhalb 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
)
{...}

Parameter

[in] NdisMiniportDataPathHandle

Der an den IHV-Miniport in MiniportWdiTalTxRxInitialize übergebene NdisMiniportDataPathHandle.

[in] PortId

Die Port-ID.

[in] PeerId

Die Peer-ID. Dies wird verwendet, um den Peer in nachfolgenden Befehlen und Hinweisen zu identifizieren.

[in] PeerAddr

Die Peer-MAC-Adresse.

Rückgabewert

Keine

Bemerkungen

Dies muss empfangen und verarbeitet werden, bevor Frames mit dem Peer ausgetauscht werden.

Ein Port, der im AP- oder Wi-Fi Direct GO-Modus ausgeführt wird, kann gleichzeitig über mehrere Peers (Clients) verfügen. Wenn ein Port im AP- oder Wi-Fi Direct GO-Modus ausgeführt wird, erstellt der IHV-Miniport einen "Peer" für gruppenadressierten Datenverkehr (durch Übergabe einer Broadcast-MAC-Adresse). Der gesamte Multicast- und Broadcastdatenverkehr für diesen Port ist diesem Peer zugeordnet. Im Portwarteschlangenmodus ist die Erstellung des Gruppenpeers durch den IHV-Miniport nicht erforderlich, da die Tx-Frameklassifizierung in diesem Modus nicht erfolgt.

Ein Port, der in einem beliebigen Modus ausgeführt wird, kann einen Gruppenpeer erstellen.

Um die TDLS-Implementierung in der IHV-Komponente zu vereinfachen, kann ein Port, der im STA- oder Wi-Fi Direct-Clientmodus ausgeführt wird, gleichzeitig mehrere Peers aufweisen. Wenn die Ziel-MAC-Adresse eines TX-Frames einer Nicht-AP/GO-Peer-ID zugeordnet ist, wird der Frame von TxMgr mit einer TID-Warteschlange in die Warteschlange gestellt, die diesem Nicht-AP/GO-Peer zugeordnet ist (wenn WDI im PeerTID-Warteschlangenmodus ausgeführt wird).

Im Peerwarteschlangenmodus wird ein Peer erstellt, bei dem alle TIDs mit WDI_TX_PAUSE_REASON_PEER_CREATE angehalten sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Windows
Kopfzeile	dot11wdi.h

Weitere Informationen

NDIS_WDI_DATA_API

Allgemeine WDI-Datenpfadschnittstellen

WDI_MAC_ADDRESS

WDI_PEER_ID

WDI_PORT_ID