次の方法で共有

DOT11_CIPHER_ALGORITHM_LIST構造体 (windot11.h)

大事な

WiFiCx は、Windows 11 でリリースされた新しい Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。 WDI ドライバー モデルはメンテナンス モードになり、優先度の高い修正プログラムのみを受け取ります。

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 を照会する場合、ミニポート ドライバーは、のミニポートOidRequest 関数の OidRequest パラメーターの InformationBuffer メンバーが、AlgorithmIds 配列内のすべてのエントリを含む、DOT11_CIPHER_ALGORITHM_LIST構造体全体を返すのに十分な大きさであることを確認する必要があります。 次の一覧に示すように、OidRequest パラメーターの InformationBufferLength メンバーの値によって、ミニポート ドライバーが実行する必要がある処理が決まります。

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

必要条件

要件 価値
サポートされる最小クライアント Windows Vista 以降で使用できます。
ヘッダー windot11.h (Ndis.h を含む)

関連項目

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR

OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_CIPHER_ALGORITHM

NDIS_OBJECT_HEADER

  • Last updated on