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 |