NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES 結構 (ndis.h)

發行項
02/29/2024

重要原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。請改用 WLAN 設備驅動器介面 (WDI) 。如需 WDI 的詳細資訊，請參閱 WLAN 通用 Windows 驅動程式模型。

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES 結構會定義Native 802.11迷你埠驅動程式和802.11月台的實體和操作屬性。

語法

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;

成員

Header

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES 結構的型別、修訂和大小。此成員的格式為 NDIS_OBJECT_HEADER 結構。

迷你埠驅動程序必須將 Header 的成員設定為下列值：

類型

此成員必須設定為 NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES。

修訂版

針對 Windows Vista 或 Windows Server 2008 操作系統，此成員必須設定為 NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_1。

對於較新版本的 Windows 作業系統，此成員必須設定為 NDIS_MINIPORT_ADAPTER_802_11_ATTRIBUTES_REVISION_2。

大小

針對 Windows Vista 或 Windows Server 2008 操作系統，此成員必須設定為 NDIS_SIZEOF_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES_REVISION_1。

對於較新版本的 Windows 作業系統，此成員必須設定為 NDIS_SIZEOF_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES_REVISION_2。

如需這些成員的詳細資訊，請參閱 NDIS_OBJECT_HEADER。

OpModeCapability

迷你埠驅動程式支援的作業模式的位掩碼。此位遮罩是透過下列項目所定義：

DOT11_OPERATION_MODE_EXTENSIBLE_AP

指定迷你埠驅動程序支援可延伸存取點 (ExtAP) 作業模式。

此值從 Windows 7 開始可用。

DOT11_OPERATION_MODE_EXTENSIBLE_STATION

指定迷你埠驅動程式支援可延伸月臺 (ExtSTA) 作業模式。

DOT11_OPERATION_MODE_NETWORK_MONITOR

指定迷你埠驅動程式支援網路監視器 (NetMon) 作業模式。

如需作業模式的詳細資訊，請參閱原生 802.11 作業模式。

NumOfTXBuffers

MAC) 服務數據單位的媒體 (訪問控制數目上限， (MSDU) 802.11 月臺可以保存在其傳輸佇列中的封包。迷你埠驅動程序必須支援最低傳輸佇列深度 64。

此成員的值不得包含 802.11 站用來自行傳送封包的傳輸緩衝區數目，例如指標封包或 802.11 控制封包。

NumOfRXBuffers

802.11 月臺在其接收佇列中可緩衝的 MSDU 封包數目上限。迷你埠驅動程序必須支援最小接收佇列深度 64。

MultiDomainCapabilityImplemented

布爾值，如果為 TRUE，則指定 802.11 站可在多個法規網域中運作。如需 802.11 法規網域的詳細資訊，請參閱 IEEE 802.11d-2001 標準。

NumSupportedPhys

802.11 站臺上的 PHY 數目。

SupportedPhyAttributes

DOT11_PHY_ATTRIBUTES 結構的陣列指標。此陣列必須有 NumSupportedPhys 專案，而且必須依照透過查詢傳回之 PHY 類型清單的順序排序 OID_DOT11_SUPPORTED_PHY_TYPES。

ExtSTAAttributes

在 Extensible Station (ExtSTA) 模式中運作時，指定迷你埠驅動程式和 802.11 月台屬性的 DOT11_EXTSTA_ATTRIBUTES 結構指標。如需此作業模式的詳細資訊，請參閱可延伸月臺作業模式。

VWiFiAttributes

DOT11_VWIFI_ATTRIBUTES 結構的指標，指定在虛擬WiFi模式中運作時，迷你埠驅動程序的屬性和802.11月臺。

此成員從 Windows 7 開始可供使用。

ExtAPAttributes

在可延伸存取點 (ExtAP) 模式中運作時，指定迷你埠驅動程序的屬性和 802.11 站的 DOT11_EXTAP_ATTRIBUTES 結構指標。

此成員從 Windows 7 開始可供使用。

WFDAttributes

DOT11_WFD_ATTRIBUTES 結構的指標，指定迷你埠驅動程序的屬性和802.11月臺在 Wi-Fi Direct (WFD) 模式中運作時。

此成員從 Windows 8 開始提供。

備註

呼叫 MiniportInitializeEx 函式時，迷你埠驅動程序必須呼叫 NdisMSetMiniportAttributes 函式可定義驅動程式的 Native 802.11 屬性和 802.11 月臺。迷你埠驅動程式在呼叫 NdisMSetMiniportAttributes 時，必須遵循下列指導方針：

MiniportAttributes 參數必須設定為驅動程式配置的記憶體區塊位址，其中包含NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES結構，以及 ExtSTA 屬性和 PHY 屬性的數位。
SupportedPhyAttributes 成員必須是 DOT11_PHY_ATTRIBUTES 結構的數位位址。此陣列必須位於 MiniportAttributes 參數所參考的驅動程式配置記憶體區塊內。
ExtSTAAttributes 成員必須是DOT11_EXTSTA_ATTRIBUTES結構的位址。這個結構必須位於 MiniportAttributes 參數所參考的驅動程式配置記憶體區塊內。