structure DOT11_EXTSTA_RECV_CONTEXT (windot11.h)
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 d’opération, consultez Modes d’opération 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 via un masque de bits.
Si le pilote miniport fonctionne en mode ExtSTA, il 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é initialement reçues 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 brutes du paquet ont été reçues avec des échecs de séquence d’images case activée (FCS).
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équence sur laquelle la station 802.11 a reçu le paquet.
usNumberOfMPDUsReceived
Nombre de fragments MPDU (Media Access Control) d’unité de données de protocole (MPDU) reçus et réassemblages 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 puissance du signal (RSSI) reçue 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ées à 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 niveau du membre pvMediaSpecificInfo . uSizeMediaSpecificInfo prend en charge la copie des informations spécifiques au média et leur transmission à une extension IHV.
pvMediaSpecificInfo
Pointeur vers une mémoire tampon qui contient des informations spécifiques au média. Le pilote miniport 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 du membre NetBufferListInfo des structures 802.3 NET_BUFFER_LIST dans NDIS reçoivent des indications.
ullTimestamp
Valeur du minuteur de la fonction de synchronisation de minutage (TSF) 802.11, 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 bruts 802.11.
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 paquets étant mises en forme en tant que structure 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 média WLAN (Wireless LAN).
Le pilote miniport accède aux données OOB natives 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.
- 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 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 versions ultérieures des systèmes d’exploitation Windows. |
| En-tête | windot11.h (inclure Ndis.h) |