DOT11_EXTSTA_ATTRIBUTES構造体 (windot11.h)
大事な
WiFiCx は、Windows 11 でリリースされた新しい Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。 WDI ドライバー モデルはメンテナンス モードになり、優先度の高い修正プログラムのみを受け取ります。
DOT11_EXTSTA_ATTRIBUTES 構造体は、ミニポート ドライバーと 802.11 ステーション拡張可能なステーション (ExtSTA) モードで動作する場合の動作属性を定義します。 この操作モードの詳細については、「拡張可能ステーション操作モードの」を参照してください。
構文
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 個の既定の暗号キー テーブルをサポートすることをお勧めします。
ステーションごとの既定の暗号キー テーブルの詳細については、「Per-Station 既定のキー」を参照してください。
bStrictlyOrderedServiceClassImplemented
TRUE 設定されている場合、メディア アクセス制御 (MAC) サービス データ ユニット (MSDU) パケット配信用に 802.11 ステーションが 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の値に応じて、このメンバーの解釈が異なります。
リビジョン = 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/ミニポートの組み合わせは、米国連邦情報処理標準 (FIPS) パブリケーション 140-2、暗号化モジュールのセキュリティ要件に基づく米国標準技術研究所 (NIST) から検証証明書を受け取りました。
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 呼び出すと、ドライバーは、ミニポートAttributes パラメーターを、DOT11_EXTSTA_ATTRIBUTES構造体と共にNDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES構造体を含むメモリのドライバー割り当てブロックのアドレスに設定します。
Windows 8 での管理フレーム保護の必須 (複合機) の適用はサポートされていません。 したがって、ミニポート ドライバーは、アソシエーション要求中に RSN IE の RSN 機能でこのビットを設定しないでください。 ポリシーの場合、アクセス ポイントは、複合機対応 STA を関連付ける複合機をアドバタイズできます。 複合機機能をサポートしていないアクセス ポイントは、関連付けに失敗します。 MFPR がアクセス ポイントによって設定され、STA が複合機に対応していない場合、Windows 8 はネットワークを機能の不一致として扱い、ミニポートに関連付け要求を送信しません。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ヘッダー | windot11.h (Ndis.h を含む) |
関連項目
OID_DOT11_EXCLUDED_MAC_ADDRESS_LIST DOT11_COUNTRY_OR_REGION_STRING OID_DOT11_PRIVACY_EXEMPTION_LIST OID_DOT11_CIPHER_KEY_MAPPING_KEY既定のキー をPer-Station する
NdisMSetMiniportAttributes の
NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES