Partager via


structure NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES (ndis.h)

important l’interface Native 802.11 Wireless LAN est déconseillée dans Windows 10 et versions ultérieures. Utilisez à la place l’interface WDI (Device Driver Interface) DU RÉSEAU LOCAL. Pour plus d’informations sur WDI, consultez modèle de pilote Windows universel LOCAL.
 
La structure NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES définit les attributs physiques et d’exploitation du pilote miniport natif 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 l’en-tête 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 d’opération pris en charge par le pilote miniport. Ce masque de bits est défini par le biais des éléments suivants :

DOT11_OPERATION_MODE_EXTENSIBLE_AP

Spécifie que le pilote miniport prend en charge le mode d’opération ExtAP (Extensible Access Point).

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 Extensible Station (ExtSTA).

DOT11_OPERATION_MODE_NETWORK_MONITOR

Spécifie que le pilote miniport prend en charge le mode d’opération Moniteur réseau (NetMon).

Pour plus d’informations sur les modes d’opération, consultez Mode d’opération natif 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 minimale de file d’attente de transmission 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 lui-même, tels que des paquets Beacon ou des 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 minimale de file d’attente de réception de 64.

MultiDomainCapabilityImplemented

Valeur booléenne qui, si 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 PHYs sur la station 802.11.

SupportedPhyAttributes

Pointeur vers un tableau de structures DOT11_PHY_ATTRIBUTES. Ce tableau doit avoir entrées numSupportedPhys et doit être triée dans le même ordre que la liste des types PHY retournés 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 la station 802.11 lors de l’exploitation en mode Extensible Station (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 la station 802.11 lorsqu’elle fonctionne en mode Wi-Fi virtuel.

Ce membre est disponible à partir de Windows 7.

ExtAPAttributes

Pointeur vers une structure 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 DOT11_WFD_ATTRIBUTES qui spécifie les attributs du pilote miniport et de la station 802.11 lorsqu’il fonctionne en mode Wi-Fi Direct (WFD).

Ce membre est disponible à partir de Windows 8.

Remarques

Lorsque sa fonction MiniportInitializeEx est appelée, le pilote miniport doit appeler le NdisMSetMiniportAttributes fonction pour définir les attributs natifs 802.11 du pilote et de la station 802.11. Le pilote miniport doit suivre ces instructions quand 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 les exigences d’initialisation d’un pilote miniport natif 802.11, consultez Initialisation du pilote Miniport native 802.11.

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
d’en-tête ndis.h

Voir aussi

mode d’opération de station extensible

modes d’opération natifs 802.11

DOT11_EXTAP_ATTRIBUTES

DOT11_EXTSTA_ATTRIBUTES

OID_DOT11_SUPPORTED_PHY_TYPES

DOT11_PHY_ATTRIBUTES

initialisation du pilote Miniport native 802.11

NdisMSetMiniportAttributes

MiniportInitializeEx

DOT11_WFD_ATTRIBUTES

DOT11_VWIFI_ATTRIBUTES

NDIS_OBJECT_HEADER