NDIS_WDI_PEER_CREATE_IND fonction de rappel (dot11wdi.h)

Article
02/26/2024

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é en 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 est passé au miniport IHV 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 de l’homologue.

Valeur de retour

None

Remarques

Celle-ci doit être reçue et traitée avant d’échanger des images 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 adressé au 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 de mise en 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 trames Tx n’a pas lieu dans ce mode.

Un port fonctionnant dans n’importe quel mode peut créer un homologue de groupe.

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

En mode de mise en file d’attente d’homologue, un homologue est créé avec tous les TID suspendus avec WDI_TX_PAUSE_REASON_PEER_CREATE.