structure DOT11_SUPPORTED_ANTENNA_LIST (windot11.h)
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) |