structure DOT11_PHY_ID_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 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_PHY_ID_LIST spécifie une liste de zéro ou plusieurs types PHY.

Syntaxe

typedef struct DOT11_PHY_ID_LIST {
  NDIS_OBJECT_HEADER Header;
  ULONG              uNumOfEntries;
  ULONG              uTotalNumOfEntries;
  ULONG              dot11PhyId[1];
} DOT11_PHY_ID_LIST, *PDOT11_PHY_ID_LIST;

Membres

Header

Type, révision et taille de la structure DOT11_PHY_ID_LIST. 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_PHY_ID_LIST_REVISION_1.

Taille

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

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

uNumOfEntries

Nombre d’entrées dans le tableau dot11PhyId .

uTotalNumOfEntries

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

dot11PhyId[1]

Liste des identificateurs PHY (ID).

Remarques

Un ID PHY dans le tableau dot11PhyId doit être l’un des suivants :

  • Index dans la table des PHYs pris en charge qui sont définis par l’objet MIB (Operational msDot11SupportedPhyTypes Management Information Base) native 802.11. Pour plus d’informations sur les ID PHY et l’objet MIB msDot11SupportedPhyTypes , consultez OID_DOT11_SUPPORTED_PHY_TYPES.
  • ID PHY avec la valeur de DOT11_PHY_ID_ANY. Cet ID PHY est appelé ID PHY générique et est utilisé pour spécifier tout PHY pris en charge sur la station 802.11. Si l’ID PHY générique est utilisé, il doit s’agir de la seule entrée dans le tableau dot11PhyId .
Un pilote miniport retourne la structure DOT11_PHY_ID_LIST lorsqu’il est interrogé par OID_DOT11_ACTIVE_PHY_LIST ou OID_DOT11_DESIRED_PHY_LIST.

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 renvoyer l’ensemble de la structure DOT11_PHY_ID_LIST, y compris toutes les entrées du tableau dot11PhyId. 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 l’ensemble de la structure DOT11_PHY_ID_LIST, 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 dot11PhyId .
    • 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.
    • Échec de 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_PHY_ID_LIST, le pilote miniport doit effectuer les opérations suivantes pour effectuer une demande de requête réussie :
    • Pour la structure DOT11_PHY_ID_LIST, définissez les membres uNumOfEntries et uTotalNumOfEntries sur le nombre total d’entrées dans le tableau dot11PhyId .
    • 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_PHY_ID_LIST. Le pilote miniport doit également copier l’ensemble de la structure DOT11_PHY_ID_LIST vers 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 les versions ultérieures des systèmes d’exploitation Windows.
En-tête windot11.h (inclure Ndis.h)

Voir aussi

OID_DOT11_ACTIVE_PHY_LIST

OID_DOT11_DESIRED_PHY_LIST

NDIS_OBJECT_HEADER