DOT11_CIPHER_ALGORITHM_LIST構造 (windot11.h)

[アーティクル]
02/27/2024

重要

ネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。代わりに WLAN デバイスドライバーインターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバーモデル」を参照してください。

DOT11_CIPHER_ALGORITHM_LIST構造体は、802.11 ステーションで有効にできる DOT11_CIPHER_ALGORITHM 構造体の一覧を定義します。

構文

typedef struct DOT11_CIPHER_ALGORITHM_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_CIPHER_ALGORITHM AlgorithmIds[1];
} DOT11_CIPHER_ALGORITHM_LIST, *PDOT11_CIPHER_ALGORITHM_LIST;

メンバー

Header

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

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

型

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

リビジョン

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

サイズ

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

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

uNumOfEntries

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

uTotalNumOfEntries

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

AlgorithmIds[1]

DOT11_CIPHER_ALGORITHM 列挙子値によって定義される暗号アルゴリズム。

暗号アルゴリズムの一覧は、優先順位によって並べ替えられます。 AlgorithmIds [0] は、優先順位が最も高い暗号アルゴリズムを定義します。

注釈

ミニポートドライバーは、OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIRまたはOID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIRによって照会されるときに、 DOT11_CIPHER_ALGORITHM_LIST 構造体を返します。

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

InformationBufferLength メンバーの値が、DOT11_CIPHER_ALGORITHM_LIST構造体全体の長さ (バイト単位) より小さい場合、ミニポートドライバーは次の操作を行う必要があります。
- OidRequest パラメーターの場合、BytesWritten メンバーを 0 に設定し、BytesNeeded メンバーをDOT11_CIPHER_ALGORITHM_LIST構造体全体の長さ (バイト単位) に設定します。
- MiniportOidRequest 関数からNDIS_STATUS_BUFFER_OVERFLOWを返して、クエリ要求を失敗します。
InformationBufferLength メンバーの値が、DOT11_CIPHER_ALGORITHM_LIST構造体全体の長さ (バイト単位) 以上の場合、ミニポートドライバーは、正常なクエリ要求を完了するために次の操作を行う必要があります。
- DOT11_CIPHER_ALGORITHM_LIST構造体の場合、 uNumOfEntries メンバーと uTotalNumOfEntries メンバーを AlgorithmIds 配列内のエントリの合計数に設定します。
- OidRequest パラメーターの場合、BytesNeeded メンバーを 0 に設定し、BytesWritten メンバーをDOT11_CIPHER_ALGORITHM_LIST構造体全体の長さ (バイト単位) に設定します。ミニポートドライバーは、 InformationBuffer メンバーにDOT11_CIPHER_ALGORITHM_LIST構造全体をコピーする必要もあります。
- MiniportOidRequest 関数からNDIS_STATUS_SUCCESSを返します。