DOT11_AUTH_CIPHER_PAIR_LIST構造 (windot11.h)

  • [アーティクル]
大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。 代わりに WLAN デバイス ドライバー インターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバー モデル」を参照してください。
 
DOT11_AUTH_CIPHER_PAIR_LIST構造体は、DOT11_AUTH_CIPHER_PAIR構造体の一覧を定義します。

構文

typedef struct DOT11_AUTH_CIPHER_PAIR_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_AUTH_CIPHER_PAIR AuthCipherPairs[1];
} DOT11_AUTH_CIPHER_PAIR_LIST, *PDOT11_AUTH_CIPHER_PAIR_LIST;

メンバー

Header

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

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

型

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

リビジョン

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

サイズ

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

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

uNumOfEntries

AuthCipherPairs 配列内のエントリの数。

uTotalNumOfEntries

AuthCipherPairs 配列に含めることができるエントリの最大数。

AuthCipherPairs[1]

の一覧 DOT11_AUTH_CIPHER_PAIR 構造体。

注釈

ミニポート ドライバーは、いずれかのクエリを実行すると、DOT11_AUTH_CIPHER_PAIR_LIST構造体を返します。 OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR または OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR。

これらの OID に対してクエリを実行する場合、ミニポート ドライバーは、MiniportOidRequest 関数の OidRequest パラメーターの InformationBuffer メンバーが、AuthCipherPairs 配列内のすべてのエントリを含む、DOT11_AUTH_CIPHER_PAIR_LIST構造全体を返すのに十分な大きさであることを確認する必要があります。 OidRequest パラメーターの InformationBufferLength メンバーの値は、次の一覧に示すように、ミニポート ドライバーが実行する必要がある処理を決定します。

  • InformationBufferLength メンバーの値が、DOT11_AUTH_CIPHER_PAIR_LIST構造体全体の長さ (バイト単位) より小さい場合、ミニポート ドライバーは次の操作を行う必要があります。
    • OidRequest パラメーターの場合、BytesWritten メンバーを 0 に設定し、BytesNeeded メンバーを、DOT11_AUTH_CIPHER_PAIR_LIST構造体全体の長さ (バイト単位) に設定します。
    • MiniportOidRequest 関数からNDIS_STATUS_BUFFER_OVERFLOWを返して、クエリ要求を失敗します。
  • InformationBufferLength メンバーの値が、DOT11_AUTH_CIPHER_PAIR_LIST構造体全体の長さ (バイト単位) 以上の場合、ミニポート ドライバーは、正常なクエリ要求を完了するために次の操作を行う必要があります。
    • DOT11_AUTH_CIPHER_PAIR_LIST構造体の場合は、 uNumOfEntries メンバーと uTotalNumOfEntries メンバーを AuthCipherPairs 配列内のエントリの合計数に設定します。
    • OidRequest パラメーターの場合は、BytesNeeded メンバーを 0 に設定し、BytesWritten メンバーをDOT11_AUTH_CIPHER_PAIR_LIST構造体全体の長さ (バイト単位) に設定します。 ミニポート ドライバーは、 InformationBuffer メンバーにDOT11_AUTH_CIPHER_PAIR_LIST構造全体をコピーする必要もあります。
    • MiniportOidRequest 関数からNDIS_STATUS_SUCCESSを返します。
Windows 7 以降では、802.11 ミニポート ドライバーは、DOT11_AUTH_CIPHER_PAIR_LISTでサポートされている認証と暗号アルゴリズムのペアの任意の組み合わせを報告できます。 ただし、オペレーティング システムが Soft AP を起動すると、 DOT11_AUTH_ALGO_RSNA_PSK 認証アルゴリズムと DOT11_CIPHER_ALGO_CCMP 暗号アルゴリズムのみが有効になります。 ソフト AP をサポートするには、ミニポート ドライバーでこの認証/暗号ペアをサポートする必要があります。

拡張 AP モードで動作している NIC で WPS が有効になっている場合、ミニポート ドライバーは、有効な承認アルゴリズムと暗号アルゴリズムに関係なく、 Open System Authentication または Wired Equivalent Privacy (WEP) アルゴリズムを使用してピア ステーションを Extensible AP に関連付けることを許可する必要があります。 WPS と Extensible AP の詳細については、「 OID_DOT11_WPS_ENABLED」を参照してください。

要件

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

こちらもご覧ください

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_AUTH_CIPHER_PAIR

NDIS_OBJECT_HEADER