DOT11_EXTSTA_ATTRIBUTES構造体 (windot11.h)

大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバー モデル」を参照してください。
 
DOT11_EXTSTA_ATTRIBUTES構造体は、拡張可能ステーション (ExtSTA) モードで動作する場合、ミニポート ドライバーと 802.11 ステーションの物理属性と操作属性を定義します。 この操作モードの詳細については、「 拡張ステーション操作モード」を参照してください。

構文

typedef struct DOT11_EXTSTA_ATTRIBUTES {
  NDIS_OBJECT_HEADER              Header;
  ULONG                           uScanSSIDListSize;
  ULONG                           uDesiredBSSIDListSize;
  ULONG                           uDesiredSSIDListSize;
  ULONG                           uExcludedMacAddressListSize;
  ULONG                           uPrivacyExemptionListSize;
  ULONG                           uKeyMappingTableSize;
  ULONG                           uDefaultKeyTableSize;
  ULONG                           uWEPKeyValueMaxLength;
  ULONG                           uPMKIDCacheSize;
  ULONG                           uMaxNumPerSTADefaultKeyTables;
  BOOLEAN                         bStrictlyOrderedServiceClassImplemented;
  UCHAR                           ucSupportedQoSProtocolFlags;
  BOOLEAN                         bSafeModeImplemented;
  ULONG                           uNumSupportedCountryOrRegionStrings;
  PDOT11_COUNTRY_OR_REGION_STRING pSupportedCountryOrRegionStrings;
  ULONG                           uInfraNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedUcastAlgoPairs;
  ULONG                           uInfraNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastAlgoPairs;
  ULONG                           uAdhocNumSupportedUcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pAdhocSupportedUcastAlgoPairs;
  ULONG                           uAdhocNumSupportedMcastAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pAdhocSupportedMcastAlgoPairs;
  BOOLEAN                         bAutoPowerSaveMode;
  ULONG                           uMaxNetworkOffloadListSize;
  BOOLEAN                         bMFPCapable;
  ULONG                           uInfraNumSupportedMcastMgmtAlgoPairs;
  PDOT11_AUTH_CIPHER_PAIR         pInfraSupportedMcastMgmtAlgoPairs;
} DOT11_EXTSTA_ATTRIBUTES, *PDOT11_EXTSTA_ATTRIBUTES;

メンバー

Header

DOT11_EXTSTA_ATTRIBUTES構造体の型、リビジョン、およびサイズ。 このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

ミニポート ドライバーは 、ヘッダー のメンバーを次の値に設定する必要があります。

このメンバーは 、NDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。

リビジョン

このメンバーは、ドライバーを実行するオペレーティング システムに応じて、次のいずれかの値に設定する必要があります。

DOT11_EXTSTA_ATTRIBUTES_REVISION_1

Windows Vista

DOT11_EXTSTA_ATTRIBUTES_REVISION_2

Windows Vista Service Pack 1 (SP1) 以降のバージョンの Windows オペレーティング システム

DOT11_EXTSTA_ATTRIBUTES_REVISION_3

Windows 8以降のバージョンの Windows オペレーティング システム

これらの値は、オペレーティング システムが bSafeModeImplemented メンバーを解釈する方法を決定します。

サイズ

このメンバーは sizeof(DOT11_EXTSTA_ATTRIBUTES) に設定する必要があります。

これらのメンバーの詳細については、「 NDIS_OBJECT_HEADER」を参照してください。

uScanSSIDListSize

スキャン操作のために 802.11 ステーションでサポートされるサービス セット識別子 (SSD) の最大数。 802.11 ステーションは、少なくとも 4 つのエントリの SSID リストをサポートする必要があります。

802.11 ステーションがスキャンに使用する SSID リストは、 OID_DOT11_SCAN_REQUEST が設定されている場合に指定されます。

uDesiredBSSIDListSize

802.11 ステーションでサポートされている基本的なサービス セット識別子 (BSSID) の目的のリスト内のエントリの最大数。 802.11 ステーションは、少なくとも 1 つのエントリを含む BSSID リストをサポートする必要があります。

目的の BSSID リストの詳細については、次を参照してください。 OID_DOT11_DESIRED_BSSID_LIST

uDesiredSSIDListSize

802.11 ステーションでサポートされている目的の SSID リスト内のエントリの最大数。 802.11 ステーションは、少なくとも 1 つのエントリを含む目的の SSID リストをサポートする必要があります。

目的の SSID リストの詳細については、次を参照してください。 OID_DOT11_DESIRED_SSID_LIST

uExcludedMacAddressListSize

802.11 ステーションでサポートされている、除外された MAC アドレス一覧内のエントリの最大数。 802.11 ステーションは、少なくとも 4 つのエントリを含む除外された MAC アドレス一覧をサポートする必要があります。

目的の除外された MAC アドレス一覧の詳細については、次を参照してください。 OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST

uPrivacyExemptionListSize

802.11 ステーションでサポートされているプライバシー除外リスト内のエントリの最大数。 802.11 ステーションは、少なくとも 1 つのエントリを含むプライバシー除外リストをサポートする必要があります。

プライバシー除外リストの詳細については、以下を参照してください。 OID_DOT11_PRIVACY_EXEMPTION_LIST

uKeyMappingTableSize

802.11 ステーションでサポートされている暗号キー マッピング キーの最大数。 802.11 ステーションでは、少なくとも 32 個のキー マッピング キーをサポートすることをお勧めします。

キー マッピング キーの詳細については、次を参照してください。 OID_DOT11_CIPHER_KEY_MAPPING_KEY

uDefaultKeyTableSize

802.11 ステーションが既定のキーとステーションごとの既定のキー テーブルに対してサポートする暗号キーの最大数。

標準の 802.11 暗号アルゴリズムの場合、802.11 ステーションは少なくとも 4 つの暗号キーのテーブル サイズをサポートする必要があります。 独立系ハードウェア ベンダー (IHV) によって開発された暗号アルゴリズムの場合、テーブル サイズは 4 つ以上にすることができます。

uWEPKeyValueMaxLength

802.11 ステーションでサポートされている WEP 暗号キーの最大長 (バイト単位)。

次の表に、 DOT11_CIPHER_ALGORITHMによって定義されたさまざまな WEP 暗号値の最小キー長と最大キー長をバイト単位で示します。

WEP 暗号 キーの最小長 キーの最大長
DOT11_CIPHER_ALGO_WEP40 5 5
DOT11_CIPHER_ALGO_WEP104 13 13
DOT11_CIPHER_ALGO_WEP 13 802.11 ステーションでサポートされている任意の長さ

uPMKIDCacheSize

802.11 ステーションでサポートされているペアワイズ マスター キー識別子 (PMKID) キャッシュ内のエントリの最大数。

802.11 ステーションが PMKID キャッシュをサポートしていない場合、ミニポート ドライバーは、このメンバーを 0 に設定する必要があります。 それ以外の場合、802.11 ステーションは、少なくとも 3 つのエントリの PMKID キャッシュ サイズをサポートする必要があります。

PMKID キャッシュの詳細については、「 OID_DOT11_PMKID_LIST」を参照してください。

uMaxNumPerSTADefaultKeyTables

802.11 ステーションでサポートされているステーションごとの既定の暗号キー テーブルの最大数。 802.11 ステーションでは、ステーションごとに少なくとも 32 個の既定の暗号キー テーブルをサポートすることをお勧めします。

ステーションごとの既定の暗号キー テーブルの詳細については、「 ステーションごとの既定のキー」を参照してください。

bStrictlyOrderedServiceClassImplemented

TRUE に設定されている場合、802.11 ステーションがメディア アクセス制御 (MAC) サービス データ ユニット (MSDU) パケット配信用の IEEE 802.11 StrictlyOrdered サービス クラスをサポートすることを指定するブール値。

StrictlyOrdered サービス クラスの詳細については、IEEE 802.11-2012 標準の第 5.1.3 項を参照してください。

ucSupportedQoSProtocolFlags

NIC が実装するサービス品質 (QoS) プロトコルを指定するフラグのセット。 このメンバーは、次のフラグの 0 またはビットごとの OR の組み合わせです。

DOT11_QOS_PROTOCOL_FLAG_WMM

NIC は、802.11 WMM QoS プロトコルを実装します。

DOT11_QOS_PROTOCOL_FLAG_11E

NIC は、802.11e QoS プロトコルを実装します。

bSafeModeImplemented

セーフ モードでは、NIC とミニポート ドライバーの組み合わせの機能がサポートされます。 オペレーティング システムでは、 Header.Revision の値に応じて、このメンバーの解釈が異なります。

Revision = DOT11_EXTSTA_ATTRIBUTES_REVISION_1

オペレーティング システムは 、bSafeModeImplemented メンバーをブール値として解釈します。 この値が TRUE の場合、NIC は 802.11 セーフ モードの操作を実装します。 それ以外の場合、値は FALSE です

リビジョン = DOT11_EXTSTA_ATTRIBUTES_REVISION_2以上

オペレーティング システムは 、bSafeModeImplemented メンバーを、次の可能なビット値が設定されたビット フィールドとして解釈します。

  • ビット フィールドが他のビットが設定されていない DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_OID_SUPPORTED に設定されている場合、ミニポート ドライバーは、操作の 802.11 セーフ モードを実装します。
  • ビット フィールドが DOT11_EXTSTA_ATTRIBUTES_SAFEMODE_CERTIFIED に設定されている場合、NIC とミニポートの組み合わせは、米国国立標準技術研究所 (NIST) から、Federal Information Processing Standards (FIPS) Publication 140-2、 暗号化モジュールのセキュリティ要件に関する検証証明書を受け取っています。
このメンバーは、 と組み合わせて使用されます OID_DOT11_SAFE_MODE_ENABLED

uNumSupportedCountryOrRegionStrings

802.11 ステーションでサポートされている国または地域の文字列の数。 802.11 ステーションが IEEE 802.11d-2001 標準で指定されている複数の規制ドメインをサポートしている場合、各国または地域の文字列は、802.11 ステーションでサポートされている規制ドメインを識別します。

802.11 ステーションが IEEE 802.11d-2001 標準をサポートしていない場合、ミニポート ドライバーは uNumSupportedCountryOrRegionStrings を 0 に設定する必要があります。

pSupportedCountryOrRegionStrings

802.11 ステーションでサポートされている 802.11d の国または地域の文字列の配列へのポインター。 配列内の各エントリは、 DOT11_COUNTRY_OR_REGION_STRING 構造体。

uInfraNumSupportedUcastAlgoPairs

インフラストラクチャ基本サービス セット (BSS) ネットワークで動作するように構成されている場合にユニキャスト パケットを送受信するために 802.11 ステーションでサポートされる認証アルゴリズムと暗号アルゴリズムの数。 uInfraNumSupportedUcastAlgoPairs メンバーは、pInfraSupportedUcastAlgoPairs メンバーによって参照される配列内のDOT11_AUTH_CIPHER_PAIR構造体の数である必要があります。

pInfraSupportedUcastAlgoPairs

インフラストラクチャ BSS ネットワークでユニキャスト パケットを送受信するために 802.11 ステーションでサポートされる認証アルゴリズムと暗号アルゴリズムの配列へのポインター。 配列内の各エントリは、 DOT11_AUTH_CIPHER_PAIR 構造体。

uInfraNumSupportedMcastAlgoPairs

インフラストラクチャ基本サービス セット (BSS) ネットワークで動作するように構成されている場合に、マルチキャストおよびブロードキャスト パケットを送受信するために 802.11 ステーションでサポートされる認証アルゴリズムと暗号アルゴリズムの数。 uInfraNumSupportedMcastAlgoPairs メンバーは、pInfraSupportedMcastAlgoPairs メンバーによって参照される配列内のDOT11_AUTH_CIPHER_PAIR構造体の数である必要があります。

pInfraSupportedMcastAlgoPairs

インフラストラクチャ BSS ネットワークでマルチキャスト パケットとブロードキャスト パケットを送受信するために 802.11 ステーションでサポートされる認証アルゴリズムと暗号アルゴリズムの配列へのポインター。 配列内の各エントリは、 DOT11_AUTH_CIPHER_PAIR 構造体。

uAdhocNumSupportedUcastAlgoPairs

独立 BSS (IBSS) ネットワークで動作するように構成されている場合にユニキャスト パケットを送受信するために 802.11 ステーションでサポートされる認証アルゴリズムと暗号アルゴリズムの数。 uAdhocNumSupportedUcastAlgoPairs メンバーは、pAdhocSupportedUcastAlgoPairs メンバーによって参照される配列内のDOT11_AUTH_CIPHER_PAIR構造体の数である必要があります。

pAdhocSupportedUcastAlgoPairs

IBSS ネットワークでユニキャスト パケットを送受信するために 802.11 ステーションでサポートされる認証アルゴリズムと暗号アルゴリズムの配列へのポインター。 配列内の各エントリは、 DOT11_AUTH_CIPHER_PAIR 構造体。

uAdhocNumSupportedMcastAlgoPairs

IBSS ネットワークで動作するように構成されている場合にマルチキャストおよびブロードキャスト パケットを送受信するために 802.11 ステーションでサポートされる認証アルゴリズムと暗号アルゴリズムの数。 uAdhocNumSupportedMcastAlgoPairs メンバーは、pAdhocSupportedMcastAlgoPairs メンバーによって参照される配列内のDOT11_AUTH_CIPHER_PAIR構造体の数である必要があります。

pAdhocSupportedMcastAlgoPairs

IBSS ネットワークでマルチキャスト パケットとブロードキャスト パケットを送受信するために 802.11 ステーションでサポートされる認証アルゴリズムと暗号アルゴリズムの配列へのポインター。 配列内の各エントリは、 DOT11_AUTH_CIPHER_PAIR 構造体。

bAutoPowerSaveMode

デバイスと Wi-Fi アクセス ポイント間の適切な Wi-Fi 省電力モード (PSM) の検出とネゴシエーションなど、自律的に電源を適切に管理するための NIC/ミニポート ドライバーの組み合わせのサポート機能。 NDIS 6.30 準拠 Wi-Fi ミニポート ドライバーは、このメンバーを TRUE に設定する必要があります。

uMaxNetworkOffloadListSize

ミニポート ドライバーがオフロードできるネットワークの最大数 (ネットワーク リスト オフロード機能をサポートする機能がある場合)。

bMFPCapable

802.11w-2009 仕様で指定されているデバイスと Wi-Fi アクセス ポイント間の管理フレーム保護をサポートするための NIC/ミニポート ドライバーの組み合わせのサポート機能。 サポートされている場合は TRUE に設定します。 それ以外の場合は、このメンバーを FALSE に設定する必要があります。

uInfraNumSupportedMcastMgmtAlgoPairs

pInfraSupportedMcastMgmtAlgoPairs で指されている認証と暗号アルゴリズムのペアの配列の長さ。

pInfraSupportedMcastMgmtAlgoPairs

デバイスが INFra モードの複合機に対してサポートする認証と暗号アルゴリズムのペアの配列へのポインター。 Windows 8に推奨される暗号は、WPA または WPA2 認証を使用した BIP です。 配列内の各エントリは、 DOT11_AUTH_CIPHER_PAIR 構造体。

bNeighborReportSupported

bAPChannelReportSupported

bActionFramesSupported

bANQPQueryOffloadSupported

bHESSIDConnectionSupported

注釈

次に、 NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES 構造体には、DOT11_EXTSTA_ATTRIBUTES構造体のアドレスを指定するメンバー (pExtSTAAttributes) が含まれています。 ミニポート ドライバーが NdisMSetMiniportAttributes を呼び出すと、ドライバーは、DOT11_EXTSTA_ATTRIBUTES構造体と共にNDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES構造体を含むメモリのドライバー割り当てブロックのアドレスに MiniportAttributes パラメーターを設定します。

Windows 8に対する管理フレーム保護の必須 (複合機) の適用はサポートされていません。 したがって、ミニポート ドライバーは、アソシエーション要求中に RSN IE の RSN 機能でこのビットを設定しないでください。 ポリシーの場合、アクセス ポイントは、複合機対応 STA の関連付けを許可する複合機をアドバタイズできます。 複合機機能をサポートしていないアクセス ポイントは、関連付けに失敗します。 アクセス ポイントによって設定されている場合、STA が複合機に対応していない場合、Windows 8はネットワークを機能の不一致として扱い、関連付け要求をミニポートに送信しません。

要件

要件
サポートされている最小のクライアント Windows 8以降のバージョンの Windows オペレーティング システムで使用できます。
Header windot11.h (Ndis.h を含む)

こちらもご覧ください

拡張可能ステーション操作モード

OID_DOT11_DESIRED_BSSID_LIST

OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST

OID_DOT11_PMKID_LIST

OID_DOT11_DESIRED_SSID_LIST

DOT11_COUNTRY_OR_REGION_STRING

OID_DOT11_SAFE_MODE_ENABLED

OID_DOT11_PRIVACY_EXEMPTION_LIST

NDIS_OBJECT_HEADER

OID_DOT11_CIPHER_KEY_MAPPING_KEY

DOT11_AUTH_CIPHER_PAIR

DOT11_CIPHER_ALGORITHM

ステーションごとの既定のキー

NdisMSetMiniportAttributes

NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES

OID_DOT11_SCAN_REQUEST