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