DOT11_CIPHER_DEFAULT_KEY_VALUE構造体 (windot11.h)
大事な
WiFiCx は、Windows 11 でリリースされた新しい Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。 WDI ドライバー モデルはメンテナンス モードになり、優先度の高い修正プログラムのみを受け取ります。
DOT11_CIPHER_DEFAULT_KEY_VALUE構造体は、802.11 ステーションのキー テーブルに追加または削除される既定の暗号キーまたはステーションごとの既定の暗号キーを定義します。 これらの暗号キーの種類の詳細については、「802.11 暗号キーの種類を参照してください。
構文
typedef struct DOT11_CIPHER_DEFAULT_KEY_VALUE {
NDIS_OBJECT_HEADER Header;
ULONG uKeyIndex;
DOT11_CIPHER_ALGORITHM AlgorithmId;
DOT11_MAC_ADDRESS MacAddr;
BOOLEAN bDelete;
BOOLEAN bStatic;
USHORT usKeyLength;
UCHAR ucKey[1];
} DOT11_CIPHER_DEFAULT_KEY_VALUE, *PDOT11_CIPHER_DEFAULT_KEY_VALUE;
メンバーズ
Header
DOT11_CIPHER_DEFAULT_KEY_VALUE構造体の型、リビジョン、およびサイズ。 このメンバーは、NDIS_OBJECT_HEADER 構造体として書式設定されます。
ミニポート ドライバーは、ヘッダー のメンバーを次の値に設定する必要があります。
種類
このメンバーは、NDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。
改定
このメンバーは、DOT11_CIPHER_DEFAULT_KEY_VALUE_REVISION_1に設定する必要があります。
大きさ
このメンバーは、sizeof(DOT11_CIPHER_DEFAULT_KEY_VALUE)に設定する必要があります。
これらのメンバーの詳細については、NDIS_OBJECT_HEADERを参照してください。
uKeyIndex
802.11 ステーションの既定のキー配列内のキーのインデックス。
標準の 802.11 暗号アルゴリズムの場合、uKeyIndex は 0 から 3 である必要があります。 IHV によって開発された暗号アルゴリズムの場合、uKeyIndex は、IHV によって定義された範囲内の任意の値にすることができます。
BIP uKeyIndex は 4 または 5 である必要があります。
IEEE 802.11-2012 標準では、1 ~ 4 の既定のキー インデックス値が定義されています。 このメンバーによって指定 x 値は、802.11 の既定のキー インデックス (x + 1) にマップされます。
AlgorithmId
このキーを使用する暗号アルゴリズムの値。 暗号アルゴリズムの値の詳細については、DOT11_CIPHER_ALGORITHMを参照してください。
BIP の場合、初期 IGTK パケット番号を事前に設定するには、これをDOT11_CIPHER_ALGO_BIPに設定する必要があります。
bDelete TRUE 場合、ミニポート ドライバーはこのメンバーを無視する必要があります。
MacAddr
メディア アクセス制御 (MAC) アドレス。キーを追加または削除する既定のキー テーブルを識別します。
dot11DesiredBSSType 管理情報ベース (MIB) オブジェクトが dot11_BSS_type_infrastructureに設定されている場合、802.11 ステーションは、MacAddr メンバーの値に関係なく、既定のキー テーブルにキーを追加または削除します。 キーがステーションが関連付けられているアクセス ポイント (AP) から動的に取得された場合、MacAddr メンバーには AP の MAC アドレスが含まれます。 それ以外の場合、MacAddr 値は 0x000000000000 になります。
dot11DesiredBSSType 管理情報ベース (MIB) オブジェクトが dot11_BSS_type_independentに設定されている場合、802.11 ステーションは次のようにキーを追加または削除する必要があります。
このメンバーの値が0x000000000000場合、802.11 ステーションは、既定のキー テーブルのキーを追加または削除します。 NIC が拡張アクセス ポイント (ExtAP) OP モードの場合、この値は 0 です。
このメンバーの値が有効なユニキャスト MAC アドレスである場合、802.11 ステーションは、MAC アドレスが macAddr の値と等しい独立 BSS (IBSS) ネットワーク内のピア ステーションのステーションごとの既定のキー テーブル キーを追加または削除します。
MacAddrの値にステーションごとの既定のキー テーブルが存在しない場合、802.11 ステーションは未使用のステーションごとの既定のキー テーブルを使用する必要があります。
dot11DesiredBSSType MIB オブジェクトの詳細については、OID_DOT11_DESIRED_BSS_TYPEを参照してください。
bDelete
ミニポート ドライバーが既定のキーを削除するかどうかを指定するブール値。
TRUE 設定されている場合、ミニポート ドライバーは、uKeyIndex によって参照される既定キーを削除する必要があります。 FALSE に設定されている場合、ミニポート ドライバーは、uKeyIndex によって参照される既定のキー 追加または更新する必要があります。
bStatic
ミニポート ドライバーが接続またはローミング操作の後に既定のキーを削除する必要があるかどうかを指定するブール値。
FALSE に設定されている場合、ミニポート ドライバーは、802.11 ステーション 常に uKeyIndex によって参照される既定のキーを削除する必要があります。
- 基本サービス セット (BSS) ネットワークから切断します。
- 新しい BSS ネットワークにローミングします。
- 同じ BSS ネットワークに再接続します。
TRUE をに設定すると、uKeyIndex によって参照される既定 キーは、次の場合を除き削除できません。
- OID_DOT11_CIPHER_DEFAULT_KEYのセット要求によって明示的に削除されました。
- OID_DOT11_RESET_REQUESTのメソッド要求によって暗黙的に削除されます。
usKeyLength
ucKey 配列内のキー マテリアルの長さ (バイト単位)。
ucKey[*]
キー マテリアル。
AlgorithmId が DOT11_CIPHER_ALGO_TKIPに設定されている場合、ucKey 配列は、DOT11_KEY_ALGO_TKIP_MIC 構造体を介してキー マテリアルを定義します。
AlgorithmId が DOT11_CIPHER_ALGO_CCMPに設定されている場合、ucKey 配列は、DOT11_KEY_ALGO_CCMP 構造体を介してキー マテリアルを定義します。
AlgorithmId が DOT11_CIPHER_ALGO_BIPに設定されている場合、ucKey 配列は、DOT11_KEY_ALGO_BIP 構造体を介してキー マテリアルを定義します。
ucKey[1]
キー マテリアル。
AlgorithmId が DOT11_CIPHER_ALGO_TKIPに設定されている場合、ucKey 配列は、DOT11_KEY_ALGO_TKIP_MIC 構造体を介してキー マテリアルを定義します。
AlgorithmId が DOT11_CIPHER_ALGO_CCMPに設定されている場合、ucKey 配列は、DOT11_KEY_ALGO_CCMP 構造体を介してキー マテリアルを定義します。
AlgorithmId が DOT11_CIPHER_ALGO_BIPに設定されている場合、ucKey 配列は、DOT11_KEY_ALGO_BIP 構造体を介してキー マテリアルを定義します。
備考
bDelete メンバーが TRUE 場合、次のメンバーは無効であり、無視する必要があります。
- bStatic
- usKeyLength を する
- ucKey を する
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ヘッダー | windot11.h (Ndis.h を含む) |