structure DOT11_SUPPORTED_ANTENNA_LIST (windot11.h)

  • Article
Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez l’interface WDI (Wlan Device Driver Interface) à la place. Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.
 
La structure DOT11_SUPPORTED_ANTENNA_LIST spécifie une liste d’antennes pouvant être utilisées pour les opérations de réception ou de transmission.

Syntaxe

typedef struct _DOT11_SUPPORTED_ANTENNA_LIST {
  ULONG                   uNumOfEntries;
  ULONG                   uTotalNumOfEntries;
  DOT11_SUPPORTED_ANTENNA dot11SupportedAntenna[1];
} DOT11_SUPPORTED_ANTENNA_LIST, *PDOT11_SUPPORTED_ANTENNA_LIST;

Membres

uNumOfEntries

Nombre d’entrées dans le tableau dot11SupportedAntenna . Une valeur zéro pour le membre uNumOfEntries indique une liste vide.

uTotalNumOfEntries

Nombre maximal d’entrées que le tableau dot11SupportedAntenna peut contenir.

dot11SupportedAntenna[1]

Liste des antennes prises en charge. Chaque élément de cette liste est au format DOT11_SUPPORTED_ANTENNA structure.

Remarques

Un pilote miniport retourne la structure DOT11_SUPPORTED_ANTENNA_LIST lorsqu’il est interrogé par OID_DOT11_SUPPORTED_RX_ANTENNA ou OID_DOT11_SUPPORTED_TX_ANTENNA.

Lorsque ces OID sont interrogés, le pilote miniport doit vérifier que le membre InformationBuffer du paramètre OidRequest de la fonction MiniportOidRequest est suffisamment grand pour retourner l’ensemble de la structure DOT11_SUPPORTED_ANTENNA_LIST, y compris toutes les entrées du tableau dot11SupportedAntenna. La valeur du membre InformationBufferLength du paramètre OidRequest détermine ce que le pilote miniport doit faire, comme le montre la liste suivante :

  • Si la valeur du membre InformationBufferLength est inférieure à la longueur, en octets, de la structure DOT11_SUPPORTED_ANTENNA_LIST entière, le pilote miniport doit effectuer les opérations suivantes :
    • Définissez le membre uNumOfEntries sur zéro.
    • Définissez le membre uTotalNumOfEntries sur le nombre d’entrées dans le tableau dot11SupportedAntenna .

      Pour le paramètre OidRequest , définissez le membre BytesWritten sur zéro et le membre BytesNeeded sur la longueur, en octets, de la structure DOT11_PHY_ID_LIST entière.

    • Faites échouer la requête en retournant NDIS_STATUS_BUFFER_OVERFLOW à partir de sa fonction MiniportOidRequest .
  • Si la valeur du membre InformationBufferLength est supérieure ou égale à la longueur, en octets, de l’ensemble de la structure DOT11_SUPPORTED_ANTENNA_LIST, le pilote miniport doit effectuer les opérations suivantes pour effectuer une requête réussie :
    • Pour la structure DOT11_SUPPORTED_ANTENNA_LIST, définissez les membres uNumOfEntries et uTotalNumOfEntries sur le nombre total d’entrées dans le tableau dot11SupportedAntenna .
    • Pour le paramètre OidRequest , définissez le membre BytesNeeded sur zéro et le membre BytesWritten sur la longueur, en octets, de l’ensemble de la structure DOT11_SUPPORTED_ANTENNA_LIST. Le pilote miniport doit également copier l’intégralité de la structure DOT11_SUPPORTED_ANTENNA_LIST dans le membre InformationBuffer .
    • Retourne NDIS_STATUS_SUCCESS à partir de sa fonction MiniportOidRequest .

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)

Voir aussi

DOT11_SUPPORTED_ANTENNA

OID_DOT11_SUPPORTED_TX_ANTENNA

OID_DOT11_SUPPORTED_RX_ANTENNA