DOT11_EXTSTA_ATTRIBUTES構造体 (windot11.h)
構文
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、 暗号化モジュールのセキュリティ要件に関する検証証明書を受け取っています。
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 を含む) |