structure DOT11_EXTSTA_RECV_CONTEXT (windot11.h)

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez plutôt l’interface WDI (WLAN Device Driver Interface). Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

La structure DOT11_EXTSTA_RECV_CONTEXT définit les attributs natifs 802.11 d’un paquet reçu par la station 802.11 et indiqués par le pilote miniport fonctionnant en mode ExtSTA (Extensible Station) ou Moniteur réseau (NetMon). Pour plus d’informations sur ces modes de fonctionnement, consultez Modes de fonctionnement natifs 802.11.

Syntaxe

typedef struct DOT11_EXTSTA_RECV_CONTEXT {
  NDIS_OBJECT_HEADER Header;
  ULONG              uReceiveFlags;
  ULONG              uPhyId;
  ULONG              uChCenterFrequency;
  USHORT             usNumberOfMPDUsReceived;
  LONG               lRSSI;
  UCHAR              ucDataRate;
  ULONG              uSizeMediaSpecificInfo;
  PVOID              pvMediaSpecificInfo;
  ULONGLONG          ullTimestamp;
} DOT11_EXTSTA_RECV_CONTEXT, *PDOT11_EXTSTA_RECV_CONTEXT;

Membres

Header

Type, révision et taille de la structure DOT11_EXTSTA_RECV_CONTEXT. Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER .

Le pilote miniport doit définir les membres de Header sur les valeurs suivantes :

Type

Ce membre doit être défini sur NDIS_OBJECT_TYPE_DEFAULT.

Révision

Ce membre doit être défini sur DOT11_EXTSTA_RECV_CONTEXT_REVISION_1.

Taille

Ce membre doit être défini sur sizeof(DOT11_EXTSTA_RECV_CONTEXT).

Pour plus d’informations sur ces membres, consultez NDIS_OBJECT_HEADER.

uReceiveFlags

Attributs des données de paquet reçues spécifiées par le biais d’un masque de bits.

Si le pilote miniport fonctionne en mode ExtSTA, le pilote doit toujours définir uReceiveFlags sur zéro.

Les valeurs d’indicateur suivantes sont valides pour le pilote miniport si fonctionne en mode NetMon.

DOT11_RECV_FLAG_RAW_PACKET

Si ce bit est défini, le paquet contient les données telles qu’elles ont été reçues à l’origine par la station 802.11. Pour plus d’informations sur les paquets bruts, consultez Indication des paquets bruts 802.11.

DOT11_RECV_FLAG_RAW_PACKET_FCS_FAILURE

Si ce bit est défini, les données de paquet brutes ont été reçues avec des échecs de séquence de trame case activée (FCS).

Note Le pilote miniport doit définir DOT11_RECV_FLAG_RAW_PACKET lors de la définition de DOT11_RECV_FLAG_RAW_PACKET_FCS_FAILURE.

DOT11_RECV_FLAG_RAW_PACKET_TIMESTAMP

Si ce bit est défini, la carte réseau définit les informations d’horodatage dans le membre ullTimestamp .

uPhyId

Identificateur (ID) du PHY sur lequel la station 802.11 a reçu le paquet.

uChCenterFrequency

Fréquence centrale du canal, en unités de mégahertz (MHz), de la bande de fréquences sur laquelle la station 802.11 a reçu le paquet.

usNumberOfMPDUsReceived

Nombre de fragments MPDU (Media Access Control) reçus et réassembles par la station 802.11 pour le paquet. La valeur de usNumberOfMPDUsReceived doit être comprise entre un et la valeur de DOT11_MAX_NUM_OF_FRAGMENTS.

lRSSI

Valeur d’indication de force du signal reçu (RSSI) pour le dernier fragment MPDU reçu du paquet 802.11. La valeur RSSI est exprimée en unités de décibels référencés à 1,0 milliwatts (dBm).

ucDataRate

Débit de données auquel la station 802.11 a reçu le paquet. La valeur de ucDataRate est la valeur du membre ucDataRateIndex du débit de données de la table de mappage de débit de données de la station 802.11. Pour plus d’informations sur la table de mappage de débit de données, consultez OID_DOT11_DATA_RATE_MAPPING_TABLE.

uSizeMediaSpecificInfo

Taille, en octets, des informations spécifiques au média au membre pvMediaSpecificInfo . uSizeMediaSpecificInfo prend en charge la copie des informations spécifiques au média et leur transmission à une extension IHV.

Note Ce membre est actuellement réservé pour une utilisation future et doit contenir zéro.

pvMediaSpecificInfo

Pointeur vers une mémoire tampon qui contient des informations spécifiques au média. Le pilote mininiport peut définir ce membre si le pilote miniport transmet des données OOB spécifiques au média à un pilote de protocole 802.3 spécifique à IHV.

L’infrastructure native 802.11 copie ce pointeur vers l’entrée MediaSpecificInformation au niveau du membre NetBufferListInfo des structures 802.3 NET_BUFFER_LIST dans NDIS reçoivent des indications.

Note Les extensions IHV ne peuvent pas recevoir l’information MediaSpecificInformation.

ullTimestamp

Valeur 802.11 du minuteur de la fonction de synchronisation (TSF), en microsecondes, qui spécifie l’heure à laquelle le paquet a été reçu. Ce membre est fourni pour prendre en charge l’indication des paquets 802.11 bruts.

Si une carte réseau ne prend pas en charge ullTimestamp, elle ne doit pas définir l’indicateur DOT11_RECV_FLAG_RAW_PACKET_TIMESTAMP dans le membre uReceiveFlags .

Remarques

Lors de l’exécution d’une opération de réception native 802.11, le pilote miniport doit mettre en forme chaque paquet 802.11 reçu en tant que structure NET_BUFFER_LIST , les données de paquet étant mises en forme en tant que structure de NET_BUFFER et liées à la structure NET_BUFFER_LIST. Chaque structure NET_BUFFER_LIST doit inclure des données hors bande (OOB). Les données OOB spécifient les attributs du paquet reçu qui sont spécifiques au support LAN sans fil (WLAN).

Le pilote miniport accède aux données OOB Native 802.11 via la macro NET_BUFFER_LIST_INFO avec les paramètres suivants :

  • Paramètre _NBL , qui est passé le pointeur vers la structure NET_BUFFER_LIST utilisée pour le paquet 802.11 reçu.
  • Paramètre _ id , qui est passé la valeur d’identificateur (ID) de MediaSpecificInformation.
Si le pilote miniport définit DOT11_RECV_FLAG_RAW_PACKET dans le membre uReceiveFlags , le pilote doit suivre ces instructions lors de la préparation de la structure DOT11_EXTSTA_RECV_CONTEXT :
  • Définissez la valeur de usNumberOfMPDUsReceived sur une.
  • Définissez la valeur de lRSSI sur la valeur RSSI pour le paquet brut lui-même.
  • Définissez la valeur de ucDataRate sur la valeur ucDataRateIndex pour le paquet brut lui-même.
  • Définissez la valeur de ucRSSI sur la valeur RSSI normalisée pour le paquet brut lui-même.
Pour plus d’informations sur les paquets bruts, consultez Indication des paquets bruts 802.11.

Pour plus d’informations sur les opérations de réception natives 802.11, consultez Opérations de réception natives 802.11.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
En-tête windot11.h (inclure Ndis.h)

Voir aussi

NdisMIndicateReceiveNetBufferLists

NET_BUFFER_LIST

NET_BUFFER

NET_BUFFER_LIST_INFO

OID_DOT11_DATA_RATE_MAPPING_TABLE

NDIS_OBJECT_HEADER