structure DOT11_PHY_ATTRIBUTES (windot11.h)

Article
02/27/2024

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_PHY_ATTRIBUTES définit les attributs physiques et d’exploitation d’un PHY sur la station 802.11.

Syntaxe

typedef struct DOT11_PHY_ATTRIBUTES {
  NDIS_OBJECT_HEADER                  Header;
  DOT11_PHY_TYPE                      PhyType;
  BOOLEAN                             bHardwarePhyState;
  BOOLEAN                             bSoftwarePhyState;
  BOOLEAN                             bCFPollable;
  ULONG                               uMPDUMaxLength;
  DOT11_TEMP_TYPE                     TempType;
  DOT11_DIVERSITY_SUPPORT             DiversitySupport;
  union {
    DOT11_HRDSSS_PHY_ATTRIBUTES HRDSSSAttributes;
    DOT11_OFDM_PHY_ATTRIBUTES   OFDMAttributes;
    DOT11_ERP_PHY_ATTRIBUTES    ERPAttributes;
  };
  ULONG                               uNumberSupportedPowerLevels;
  ULONG                               TxPowerLevels[8];
  ULONG                               uNumDataRateMappingEntries;
  DOT11_DATA_RATE_MAPPING_ENTRY       DataRateMappingEntries[DOT11_RATE_SET_MAX_LENGTH];
  DOT11_SUPPORTED_DATA_RATES_VALUE_V2 SupportedDataRatesValue;
} DOT11_PHY_ATTRIBUTES, *PDOT11_PHY_ATTRIBUTES;

Membres

Header

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

Taille

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

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

PhyType

Type du PHY tel que spécifié par une valeur d’énumérateur DOT11_PHY_TYPE .

bHardwarePhyState

Valeur booléenne qui spécifie l’état d’alimentation matérielle du PHY. Si la valeur est TRUE, l’état d’alimentation du matériel est activé. Si la valeur est FALSE, l’état d’alimentation du matériel est désactivé.

Pour plus d’informations sur l’état d’alimentation matérielle du PHY, consultez OID_DOT11_HARDWARE_PHY_STATE.

Note Chaque fois que l’état d’alimentation matérielle du PHY change, le pilote miniport doit effectuer une NDIS_STATUS_DOT11_PHY_STATE_CHANGED indication de status spécifique au média.

bSoftwarePhyState

Valeur booléenne qui spécifie l’état d’alimentation logicielle du PHY. Si la valeur est TRUE, l’état d’alimentation du logiciel est activé. Si la valeur est FALSE, l’état d’alimentation du logiciel est désactivé.

Pour plus d’informations sur l’état d’alimentation logicielle du PHY, consultez OID_DOT11_NIC_POWER_STATE.

Note Chaque fois que l’état d’alimentation du logiciel du PHY change, le pilote miniport doit effectuer une NDIS_STATUS_DOT11_PHY_STATE_CHANGED indication de status spécifique au média.

bCFPollable

Valeur booléenne qui, si elle est définie sur TRUE, indique que la station 802.11 prend en charge les trames CF-Poll. Pour plus d’informations sur les trames CF-Poll, reportez-vous à la clause 9.4 de la norme IEEE 802.11-2012.

Ce membre n’est pas applicable au mode d’opération Du point d’accès extensible (ExtAP) et est ignoré lorsque la carte réseau est en mode ExtAP.

uMPDUMaxLength

Longueur maximale, en octets, d’une image MPDU (Media Access Control) que le PHY peut transmettre ou recevoir. Pour plus d’informations, consultez OID_DOT11_MPDU_MAX_LENGTH.

Note Chaque fois que l’état d’alimentation du logiciel du PHY change, le pilote miniport doit faire une indication NDIS_STATUS_DOT11_MPDU_MAX_LENGTH_CHANGED status spécifique au média.

TempType

Plage de température de fonctionnement du PHY, définie par une valeur d’énumération DOT11_TEMP_TYPE .

DiversitySupport

Le type de diversité d’antenne du PHY, défini par une valeur d’énumération DOT11_DIVERSITY_SUPPORT .

PhySpecificAttributes

PhySpecificAttributes.HRDSSSAttributes

Attributs propres à PHY d’un type PHY à fréquence élevée de spectre de répartition de séquence directe (HRDSS). Le pilote miniport doit utiliser ce membre uniquement si le membre PhyType est défini sur dot11_phy_type_hrdsss.

PhySpecificAttributes.OFDMAttributes

Attributs spécifiques à PHY d’un type PHY of orthogonal frequency division multiplexing (OFDM). Le pilote miniport doit utiliser ce membre uniquement si le membre PhyType est défini sur dot11_phy_type_ofdm.

PhySpecificAttributes.ERPAttributes

Attributs spécifiques à PHY d’un type PHY (ERP) à débit étendu. Le pilote miniport doit utiliser ce membre uniquement si le membre PhyType est défini sur dot11_phy_type_erp.

Remarques

The NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure contient un membre (pExtPhyAttributes) qui spécifie l’adresse d’un tableau de structures DOT11_PHY_ATTRIBUTES. Lorsque le pilote miniport appelle NdisMSetMiniportAttributes, le pilote définit le paramètre MiniportAttributes sur l’adresse du bloc de mémoire alloué par le pilote qui contient une structure NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES ainsi que le tableau de DOT11_PHY_ATTRIBUTES structure.

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)