NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure (ndis.h)

Article
02/29/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 NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES définit les attributs physiques et de fonctionnement du pilote miniport Native 802.11 et de la station 802.11.

Syntaxe

typedef struct {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    OpModeCapability;
  ULONG                    NumOfTXBuffers;
  ULONG                    NumOfRXBuffers;
  BOOLEAN                  MultiDomainCapabilityImplemented;
  ULONG                    NumSupportedPhys;
  PDOT11_PHY_ATTRIBUTES    SupportedPhyAttributes;
  PDOT11_EXTSTA_ATTRIBUTES ExtSTAAttributes;
#if (NDIS_SUPPORT_NDIS620)
  PDOT11_VWIFI_ATTRIBUTES  VWiFiAttributes;
  PDOT11_EXTAP_ATTRIBUTES  ExtAPAttributes;
#endif
#if (NDIS_SUPPORT_NDIS630)
  PDOT11_WFD_ATTRIBUTES    WFDAttributes;
#endif
} NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES;

Membres

Header

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

Révision

Pour les systèmes d’exploitation Windows Vista ou Windows Server 2008, ce membre doit être défini sur NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_1.

Pour les versions ultérieures des systèmes d’exploitation Windows, ce membre doit être défini sur NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_2.

Taille

Pour les systèmes d’exploitation Windows Vista ou Windows Server 2008, ce membre doit être défini sur NDIS_SIZEOF_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES_REVISION_1.

Pour les versions ultérieures des systèmes d’exploitation Windows, ce membre doit être défini sur NDIS_SIZEOF_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES_REVISION_2.

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

OpModeCapability

Masque de bits des modes de fonctionnement pris en charge par le pilote miniport. Ce masque de bits est défini par les éléments suivants :

DOT11_OPERATION_MODE_EXTENSIBLE_AP

Spécifie que le pilote miniport prend en charge le mode d’opération De point d’accès extensible (ExtAP).

Cette valeur est disponible à partir de Windows 7.

DOT11_OPERATION_MODE_EXTENSIBLE_STATION

Spécifie que le pilote miniport prend en charge le mode d’opération ExtSTA (Extensible Station).

DOT11_OPERATION_MODE_NETWORK_MONITOR

Spécifie que le pilote miniport prend en charge le mode d’opération Network Monitor (NetMon).

Pour plus d’informations sur les modes d’opération, consultez Modes d’opération natifs 802.11.

NumOfTXBuffers

Nombre maximal de paquets MSDU (Media Access Control) que la station 802.11 peut contenir dans sa file d’attente de transmission. Le pilote miniport doit prendre en charge une profondeur de file d’attente de transmission minimale de 64.

La valeur de ce membre ne doit pas inclure le nombre de mémoires tampons de transmission que la station 802.11 utilise pour envoyer des paquets par elle-même, comme les paquets Beacon ou les paquets de contrôle 802.11.

NumOfRXBuffers

Nombre maximal de paquets MSDU que la station 802.11 peut mettre en mémoire tampon dans sa file d’attente de réception. Le pilote miniport doit prendre en charge une profondeur de file d’attente de réception minimale de 64.

MultiDomainCapabilityImplemented

Valeur booléenne qui, si elle est TRUE, spécifie que la station 802.11 peut fonctionner dans plusieurs domaines réglementaires. Pour plus d’informations sur les domaines réglementaires 802.11, reportez-vous à la norme IEEE 802.11d-2001.

NumSupportedPhys

Nombre de PH sur la station 802.11.

SupportedPhyAttributes

Pointeur vers un tableau de structures DOT11_PHY_ATTRIBUTES . Ce tableau doit avoir des entrées NumSupportedPhys et doit être trié dans le même ordre que la liste des types PHY retournée par le biais d’une requête de OID_DOT11_SUPPORTED_PHY_TYPES.

ExtSTAAttributes

Pointeur vers une structure DOT11_EXTSTA_ATTRIBUTES qui spécifie les attributs du pilote miniport et de la station 802.11 lors du fonctionnement en mode De station extensible (ExtSTA). Pour plus d’informations sur ce mode d’opération, consultez Mode d’opération de station extensible.

VWiFiAttributes

Pointeur vers une structure DOT11_VWIFI_ATTRIBUTES qui spécifie les attributs du pilote miniport et de la station 802.11 lorsqu’il fonctionne en mode Wi-Fi virtuel.

Ce membre est disponible à partir de Windows 7.

ExtAPAttributes

Pointeur vers une structure de DOT11_EXTAP_ATTRIBUTES qui spécifie les attributs du pilote miniport et de la station 802.11 lorsqu’il fonctionne en mode ExtAP (Extensible Access Point).

Ce membre est disponible à partir de Windows 7.

WFDAttributes

Pointeur vers une structure de DOT11_WFD_ATTRIBUTES qui spécifie les attributs du pilote miniport et de la station 802.11 lorsqu’il fonctionne en mode direct Wi-Fi (WFD).

Ce membre est disponible à partir de Windows 8.

Remarques

Lorsque sa fonction MiniportInitializeEx est appelée, le pilote miniport doit appeler le Fonction NdisMSetMiniportAttributes pour définir les attributs Native 802.11 du pilote et de la station 802.11. Le pilote miniport doit suivre ces instructions lorsqu’il effectue l’appel à NdisMSetMiniportAttributes :

Le paramètre MiniportAttributes doit être défini sur l’adresse d’un bloc de mémoire alloué par le pilote qui contient une structure NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES ainsi que les attributs ExtSTA et un tableau d’attributs PHY.
Le membre SupportedPhyAttributes doit être l’adresse du tableau de structures DOT11_PHY_ATTRIBUTES . Ce tableau doit se trouver dans le bloc de mémoire alloué au pilote référencé par le paramètre MiniportAttributes .
Le membre ExtSTAAttributes doit être l’adresse d’une structure DOT11_EXTSTA_ATTRIBUTES . Cette structure doit se trouver dans le bloc de mémoire alloué au pilote référencé par le paramètre MiniportAttributes .

Pour plus d’informations sur la configuration requise pour l’initialisation d’un pilote miniport Natif 802.11, consultez Initialisation du pilote Miniport Native 802.11.