NDIS_WDI_PEER_CREATE_IND Rückruffunktion (dot11wdi.h)

Artikel
02/06/2025

Wichtig

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

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

Dies ist ein Rückruf in 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

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

[in] PortId

Die Port-ID.

[in] PeerId

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

[in] PeerAddr

Die Peer-MAC-Adresse.

Rückgabewert

Nichts

Bemerkungen

Dies muss vor dem Austausch von Frames mit dem Peer empfangen und verarbeitet werden.

Ein Port, der in AP oder Wi-Fi Direct GO-Modus ausgeführt wird, kann gleichzeitig mehrere Peers (Clients) aufweisen. Wenn ein Port im AP- oder Wi-Fi Direct GO-Modus ausgeführt wird, erstellt der IHV-Miniport einen "Peer" für den adressierten Datenverkehr der Gruppe (durch Übergeben einer Broadcast-MAC-Adresse). Alle Multicast- und Übertragungsdatenverkehr für diesen Port sind diesem Peer zugeordnet. Im Portwarteschlangenmodus ist die Erstellung des Gruppenspeers durch den IHV-Miniport nicht erforderlich, da die Tx-Frameklassifizierung in diesem Modus nicht auftritt.

Ein Port, der in jedem Modus ausgeführt wird, kann einen Gruppenspeer erstellen.

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

Im Peer-Warteschlangenmodus wird ein Peer mit allen TIDs erstellt, die mit WDI_TX_PAUSE_REASON_PEER_CREATEangehalten wurden.