DOT11_AUTH_CIPHER_PAIR_LIST構造体 (windot11.h)
大事な
WiFiCx は、Windows 11 でリリースされた新しい Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。 WDI ドライバー モデルはメンテナンス モードになり、優先度の高い修正プログラムのみを受け取ります。
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 を照会する場合、ミニポート ドライバーは、ミニポートOidRequest 関数の 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構造体全体の長さ (バイト単位) に設定します。
- ミニポートOidRequest 関数から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構造全体をコピーする必要もあります。
- ミニポートOidRequest 関数からNDIS_STATUS_SUCCESSを返します。
拡張可能 AP モードで動作している NIC で WPS が有効になっている場合、ミニポート ドライバーは、有効な承認アルゴリズムと暗号アルゴリズムに関係なく、オープン システム認証 または ワイヤード 同等のプライバシー (WEP) アルゴリズムを使用して、ピア ステーションを Extensible AP に関連付けできるようにする必要があります。 WPS および Extensible AP の詳細については、OID_DOT11_WPS_ENABLEDを参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ヘッダー | windot11.h (Ndis.h を含む) |