NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES-Struktur (ndis.h)

Wichtig Die native WLAN-Schnittstelle 802.11 ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows driver model.
 
Die NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES-Struktur definiert die physischen und operativen Attribute des Native 802.11-Miniporttreibers und der Station 802.11.

Syntax

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;

Member

Header

Typ, Revision und Größe der NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES-Struktur. Dieser Member ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss die Member von Header auf die folgenden Werte festlegen:

Typ

Dieser Member muss auf NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES festgelegt werden.

Revision

Für die Betriebssysteme Windows Vista oder Windows Server 2008 muss dieses Element auf NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_1 festgelegt werden.

Für höhere Versionen der Windows-Betriebssysteme muss dieser Member auf NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_2 festgelegt werden.

Size

Für die Betriebssysteme Windows Vista oder Windows Server 2008 muss dieser Member auf NDIS_SIZEOF_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES_REVISION_1 festgelegt werden.

Für höhere Versionen der Windows-Betriebssysteme muss dieser Member auf NDIS_SIZEOF_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES_REVISION_2 festgelegt werden.

Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.

OpModeCapability

Eine Bitmaske der vom Miniporttreiber unterstützten Betriebsmodi. Diese Bitmaske wird wie folgt definiert:

DOT11_OPERATION_MODE_EXTENSIBLE_AP

Gibt an, dass der Miniporttreiber den Extensible Access Point -Betriebsmodus (Extensible Access Point, ExtAP) unterstützt.

Dieser Wert ist ab Windows 7 verfügbar.

DOT11_OPERATION_MODE_EXTENSIBLE_STATION

Gibt an, dass der Miniporttreiber den Extsta-Betriebsmodus (Extensible Station) unterstützt.

DOT11_OPERATION_MODE_NETWORK_MONITOR

Gibt an, dass der Miniporttreiber den Betriebsmodus Netzwerkmonitor (NetMon) unterstützt.

Weitere Informationen zu Betriebsmodi finden Sie unter Native 802.11-Betriebsmodi.

NumOfTXBuffers

Die maximale Anzahl von MSDU-Paketen (Media Access Control) für die Medienzugriffssteuerung (Media Access Control), die die 802.11-Station in ihrer Übertragungswarteschlange enthalten kann. Der Miniporttreiber muss eine mindeste Übertragungswarteschlangentiefe von 64 unterstützen.

Der Wert dieses Members darf nicht die Anzahl der Übertragungspuffer enthalten, die die Station 802.11 zum eigenständigen Senden von Paketen verwendet, z. B. Beaconpakete oder 802.11-Steuerpakete.

NumOfRXBuffers

Die maximale Anzahl von MSDU-Paketen, die die 802.11-Station in ihrer Empfangswarteschlange puffern kann. Der Miniporttreiber muss eine mindeste Empfangswarteschlangentiefe von 64 unterstützen.

MultiDomainCapabilityImplemented

Ein boolescher Wert, der bei TRUE angibt, dass die Station 802.11 in mehreren regulatorischen Domänen betrieben werden kann. Weitere Informationen zu 802.11-Regulierungsdomänen finden Sie im IEEE 802.11d-2001-Standard.

NumSupportedPhys

Die Anzahl der PHYs auf der Station 802.11.

SupportedPhyAttributes

Ein Zeiger auf ein Array von DOT11_PHY_ATTRIBUTES Strukturen. Dieses Array muss NumSupportedPhys-Einträge aufweisen und in derselben Reihenfolge wie die Liste der PHY-Typen sortiert werden, die über eine Abfrage von zurückgegeben werden. OID_DOT11_SUPPORTED_PHY_TYPES.

ExtSTAAttributes

Ein Zeiger auf eine DOT11_EXTSTA_ATTRIBUTES-Struktur , die die Attribute des Miniporttreibers und der 802.11-Station angibt, wenn sie im ExtSTA-Modus (Extensible Station) betrieben wird. Weitere Informationen zu diesem Betriebsmodus finden Sie unter Betriebsmodus für erweiterbare Stationen.

VWiFiAttributes

Ein Zeiger auf eine DOT11_VWIFI_ATTRIBUTES-Struktur , die die Attribute des Miniporttreibers und der 802.11-Station angibt, wenn sie im virtuellen WLAN-Modus ausgeführt wird.

Dieses Mitglied ist ab Windows 7 verfügbar.

ExtAPAttributes

Ein Zeiger auf eine DOT11_EXTAP_ATTRIBUTES-Struktur , die die Attribute des Miniporttreibers und der 802.11-Station angibt, wenn sie im ExtAP-Modus (Extensible Access Point) ausgeführt wird.

Dieses Mitglied ist ab Windows 7 verfügbar.

WFDAttributes

Ein Zeiger auf eine DOT11_WFD_ATTRIBUTES-Struktur , die die Attribute des Miniporttreibers und der Station 802.11 angibt, wenn sie im Wi-Fi Direkten Modus (WFD) ausgeführt wird.

Dieses Mitglied ist ab Windows 8 verfügbar.

Hinweise

Wenn die MiniportInitializeEx-Funktion aufgerufen wird, muss der Miniporttreiber den NdisMSetMiniportAttributes-Funktion , um die Native 802.11-Attribute des Treibers und der 802.11-Station zu definieren. Der Miniporttreiber muss diese Richtlinien befolgen, wenn er NdisMSetMiniportAttributes aufruft:

  • Der MiniportAttributes-Parameter muss auf die Adresse eines vom Treiber zugewiesenen Speicherblocks festgelegt werden, der eine NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES-Struktur zusammen mit den ExtSTA-Attributen und einem Array von PHY-Attributen enthält.
  • Das SupportedPhyAttributes-Element muss die Adresse des Arrays von DOT11_PHY_ATTRIBUTES Strukturen sein. Dieses Array muss sich innerhalb des vom Treiber zugewiesenen Speicherblocks befinden, auf den vom MiniportAttributes-Parameter verwiesen wird.
  • Das ExtSTAAttributes-Element muss die Adresse einer DOT11_EXTSTA_ATTRIBUTES-Struktur sein. Diese Struktur muss sich innerhalb des vom Treiber zugewiesenen Speicherblocks befinden, auf den vom MiniportAttributes-Parameter verwiesen wird.
Weitere Informationen zu den Initialisierungsanforderungen für einen nativen 802.11-Miniporttreiber finden Sie unter Native 802.11 Miniport-Treiberinitialisierung.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile ndis.h

Weitere Informationen

Erweiterbarer Stationsbetriebsmodus

Native 802.11-Betriebsmodi

DOT11_EXTAP_ATTRIBUTES

DOT11_EXTSTA_ATTRIBUTES

OID_DOT11_SUPPORTED_PHY_TYPES

DOT11_PHY_ATTRIBUTES

Native 802.11 Miniport-Treiberinitialisierung

NdisMSetMiniportAttributes

MiniportInitializeEx

DOT11_WFD_ATTRIBUTES

DOT11_VWIFI_ATTRIBUTES

NDIS_OBJECT_HEADER