NDIS_WDI_PEER_CREATE_IND fonction de rappel (dot11wdi.h)

Article
02/06/2025

Important

Cette rubrique fait partie du modèle de pilote WDI publié dans Windows 10. Le modèle de pilote WDI est en mode maintenance et ne reçoit que des correctifs de priorité élevée. WiFiCx est le modèle de pilote Wi-Fi publié dans Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités.

La fonction de rappel NdisWdiPeerCreateIndication spécifie un ID d’homologue à associer à une adresse MAC homologue.

Il s’agit d’un rappel à l’intérieur NDIS_WDI_DATA_API.

Syntaxe

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

Paramètres

[in] NdisMiniportDataPathHandle

Le NdisMiniportDataPathHandle passé à IHV miniport dans MiniportWdiTalTxRxInitialize.

[in] PortId

ID de port.

[in] PeerId

ID d’homologue. Il est utilisé pour identifier l’homologue dans les commandes et indications suivantes.

[in] PeerAddr

Adresse MAC homologue.

Valeur de retour

Aucun

Remarques

Cela doit être reçu et traité avant d’échanger des trames avec l’homologue.

Un port fonctionnant en MODE AP ou Wi-Fi Direct GO peut avoir simultanément plusieurs homologues (clients). Lorsqu’un port fonctionne en mode AP ou Wi-Fi Direct GO, le miniport IHV crée un « homologue » pour le trafic traité par le groupe (en passant une adresse MAC de diffusion). Tout le trafic de multidiffusion et de diffusion pour ce port est associé à cet homologue. En mode file d’attente de port, la création de l’homologue de groupe par le miniport IHV n’est pas nécessaire, car la classification des images Tx ne se produit pas dans ce mode.

Un port fonctionnant en tout mode peut créer un homologue de groupe.

Pour faciliter l’implémentation TDLS dans le composant IHV, un port fonctionnant en STA ou Wi-Fi mode client direct peut avoir simultanément plusieurs homologues. Si l’adresse MAC de destination d’un frame TX correspond à un ID homologue non-AP/GO, TxMgr met en file d’attente le frame avec une file d’attente TID associée à ce pair non-AP/GO (si WDI fonctionne en mode file d’attente PeerTID).

En mode file d’attente d’homologue, un homologue est créé avec toutes les TID suspendues avec WDI_TX_PAUSE_REASON_PEER_CREATE.