DOT11_ASSOCIATION_COMPLETION_PARAMETERS構造体 (windot11.h)
大事な
WiFiCx は、Windows 11 でリリースされた新しい Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。 WDI ドライバー モデルはメンテナンス モードになり、優先度の高い修正プログラムのみを受け取ります。
DOT11_ASSOCIATION_COMPLETION_PARAMETERS構造体は、アクセス ポイント (AP) またはピア ステーションを使用して 802.11 ステーションによって実行される関連付け操作の結果を指定します。 ネイティブ 802.11 ミニポート ドライバーには、ミニポート ドライバーが NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 状態の表示を行うときにDOT11_ASSOCIATION_COMPLETION_PARAMETERS構造が含まれています。
構文
typedef struct DOT11_ASSOCIATION_COMPLETION_PARAMETERS {
NDIS_OBJECT_HEADER Header;
DOT11_MAC_ADDRESS MacAddr;
DOT11_ASSOC_STATUS uStatus;
BOOLEAN bReAssocReq;
BOOLEAN bReAssocResp;
ULONG uAssocReqOffset;
ULONG uAssocReqSize;
ULONG uAssocRespOffset;
ULONG uAssocRespSize;
ULONG uBeaconOffset;
ULONG uBeaconSize;
ULONG uIHVDataOffset;
ULONG uIHVDataSize;
DOT11_AUTH_ALGORITHM AuthAlgo;
DOT11_CIPHER_ALGORITHM UnicastCipher;
DOT11_CIPHER_ALGORITHM MulticastCipher;
ULONG uActivePhyListOffset;
ULONG uActivePhyListSize;
BOOLEAN bFourAddressSupported;
BOOLEAN bPortAuthorized;
UCHAR ucActiveQoSProtocol;
DOT11_DS_INFO DSInfo;
ULONG uEncapTableOffset;
ULONG uEncapTableSize;
DOT11_CIPHER_ALGORITHM MulticastMgmtCipher;
ULONG uAssocComebackTime;
} DOT11_ASSOCIATION_COMPLETION_PARAMETERS, *PDOT11_ASSOCIATION_COMPLETION_PARAMETERS;
メンバーズ
Header
DOT11_ASSOCIATION_COMPLETION_PARAMETERS構造体の型、リビジョン、およびサイズ。 このメンバーは、NDIS_OBJECT_HEADER 構造体として書式設定されます。
ミニポート ドライバーは、ヘッダー のメンバーを次の値に設定する必要があります。
種類
このメンバーは、NDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。
改定
このメンバーは、DOT11_ASSOCIATION_COMPLETION_PARAMETERS_REVISION_1に設定する必要があります。
大きさ
このメンバーは、sizeof(DOT11_ASSOCIATION_COMPLETION_PARAMETERS)
に設定する必要があります。
これらのメンバーの詳細については、NDIS_OBJECT_HEADERを参照してください。
MacAddr
802.11 ステーションが接続しようとしたアクセス ポイント (AP) のメディア アクセス制御 (MAC) アドレス (インフラストラクチャ BSS ネットワークの場合) またはピア ステーション (独立した BSS (IBSS) ネットワークの場合)。
uStatus
関連付け操作の完了状態。DOT11_ASSOC_STATUSに定義された値で指定されます。
bReAssocReq
802.11 ステーションが 802.11 アソシエーション フレームまたは再関連付けフレームを AP に送信したかどうかを示すブール値。 TRUE 場合、802.11 ステーションは AP に 801.11 再関連付け要求フレームを送信しました。 FALSE 場合、802.11 ステーションは AP に 802.11 アソシエーション要求フレームを送信しました。
bReAssocReq メンバー TRUE の値は、dot11DesiredBSSType MIB オブジェクトが dot11_BSS_type_infrastructureに設定されている場合にのみ有効です。
bReAssocResp
802.11 ステーションが AP から 802.11 Association または Reassociation フレームを受信したかどうかを示すブール値。 TRUE 場合、802.11 ステーションは AP から 802.11 再関連付け応答フレームを受信しました。 FALSE 場合、802.11 ステーションは AP から 802.11 アソシエーション応答フレームを受信しました。
bReAssocResp メンバー TRUE の値は、dot11DesiredBSSType MIB オブジェクトが dot11_BSS_type_infrastructureに設定されている場合にのみ有効です。
uAssocReqOffset
関連付け操作で使用される要求フレームのオフセット。 フレームに 802.11 MAC ヘッダーは含まれません。
このオフセットは、DOT11_ASSOCIATION_COMPLETION_PARAMETERS構造体を含むバッファーの先頭を基準にしています。
ミニポート ドライバーによって返される関連付け要求フレームは、IEEE 802.11 dot11DesiredBSSType MIB オブジェクトの設定によって異なります。
- dot11DesiredBSSType MIB オブジェクトがdot11_BSS_type_infrastructureに設定されている場合、 フレームは、AP に送信された 802.11 関連付け要求フレーム (bReAssocReq が FALSE の場合) または再関連付け要求フレーム (bReAssocReq が TRUE 場合) のいずれかです。ミニポート ドライバーは、アソシエーション イニシエーターによって送信されるか、関連付け操作中に交換された情報に基づいてドライバーによって作成された 802.11 プローブ要求フレームを返す必要があります。
- dot11DesiredBSSType MIB オブジェクトがdot11_BSS_type_independentに設定されている場合、ミニポート ドライバーは、uAssocReqOffset メンバーを 0 に設定する必要があります。
ミニポート ドライバーは、uAssocReqOffset を設定し、関連付け操作中に要求フレームを送信できなかった場合は、uAssocReqSize メンバーを 0 に する必要があります。 たとえば、AP が 802.11 ステーションによって送信された 802.11 認証フレームに失敗した場合、ミニポート ドライバーは uAssocReqOffset 設定し、uAssocReqSize を 0 に する必要があります。
uAssocReqSize
関連付け操作で使用される要求フレームの長さ。 フレームの長さには、802.11 MAC ヘッダーは含まれません。
dot11DesiredBSSType MIB オブジェクトが dot11_BSS_type_independentに設定されている場合、ミニポート ドライバーは、uAssocReqSize メンバーを 0 に設定する必要があります。
uAssocRespOffset
関連付け操作で使用される応答フレームのオフセット。 フレームに 802.11 MAC ヘッダーは含まれません。
このオフセットは、DOT11_ASSOCIATION_COMPLETION_PARAMETERS構造体を含むバッファーの開始を基準にしています。
ミニポート ドライバーによって返される関連付けの応答フレームは、IEEE 802.11 dot11DesiredBSSType MIB オブジェクトの設定によって異なります。
dot11DesiredBSSType MIB オブジェクトがdot11_BSS_type_infrastructureに設定されている場合、 フレームは、AP から受信した 802.11 関連付け応答フレーム (bReAssocReq が TRUE の場合) または再関連付け応答フレーム (bReAssocReq が FALSE 場合) のいずれかです。 ミニポート ドライバーは、関連付けイニシエーターに送信されるか、関連付け操作中に交換された情報に基づいてドライバーによって作成された 802.11 プローブ応答フレームを返す必要があります。
dot11DesiredBSSType MIB オブジェクトがdot11_BSS_type_independentに設定されている場合、ミニポート ドライバーは、uAssocRespOffset メンバーを 0 に設定する必要があります。
ミニポート ドライバーは、関連付け操作中に応答フレームを受信しなかった場合、uAssocRespOffset を設定し、uAssocRespSize メンバーを 0 に する必要があります。
uAssocRespSize
関連付け操作で使用される応答フレームの長さ。 フレームの長さには、802.11 MAC ヘッダーは含まれません。
dot11DesiredBSSType MIB オブジェクトが dot11_BSS_type_independentに設定されている場合、ミニポート ドライバーは、uAssocRespSize メンバーを 0 に設定する必要があります。
uBeaconOffset
最後に受信した 802.11 ビーコンまたはプローブ応答フレームのオフセット。 ミニポート ドライバーは、これらのフレームの 802.11 MAC ヘッダーを除外する必要があります NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 状態を示します。
このオフセットは、DOT11_ASSOCIATION_COMPLETION_PARAMETERS構造体を含むバッファーの開始を基準にしています。
手記
関連付けに使用される認証アルゴリズムが保護されたアクセス (WPA) または IEEE 802.11i 堅牢なセキュリティ ネットワーク アソシエーション (RSNA) Wi-Fi された場合、ミニポート ドライバーは常に最後に受信した 802.11 ビーコン フレームを返す必要があり、uBeaconOffset および uBeaconSize メンバーをゼロに設定しないでください。
uBeaconSize
最後に受信した 802.11 ビーコン フレームの長さ。 フレームの長さには、802.11 MAC ヘッダーは含まれません。
uIHVDataOffset
IHV によって定義される独自の形式のデータ ブロックのオフセット。 IHV は、NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 状態表示に関連するすべての目的で、このデータ ブロックを使用できます。
このオフセットは、DOT11_ASSOCIATION_COMPLETION_PARAMETERS構造体を含むバッファーの開始を基準にしています。
ミニポート ドライバーが NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 状態表示で IHV データを返さない場合は、uIHVDataOffset 0 に設定する必要があります。
uIHVDataSize
NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 状態表示のために IHV によって使用されるデータ ブロックの長さ。 ミニポート ドライバーがこの指示で IHV データを返していない場合は、uIHVDataSize 0 に設定する必要があります。
AuthAlgo
関連付け操作中に 802.11 ステーションが AP またはピア ステーションで解決した認証アルゴリズム。 AuthAlgo メンバーのデータ型の詳細については、DOT11_AUTH_ALGORITHMを参照してください。
ミニポート ドライバーは、uStatus が DOT11_ASSOCIATION_STATUS_SUCCESS に設定されていない場合、このメンバーを 0 に設定する必要があります。
UnicastCipher
関連付け操作中に 802.11 ステーションが AP またはピア ステーションで解決したユニキャスト暗号アルゴリズム。 ユニキャストCipher メンバーのデータ型の詳細については、DOT11_CIPHER_ALGORITHMを参照してください。
ミニポート ドライバーは、uStatus が DOT11_ASSOCIATION_STATUS_SUCCESS に設定されていない場合、このメンバーを 0 に設定する必要があります。
MulticastCipher
アソシエーション操作中に 802.11 ステーションが AP またはピア ステーションで解決したマルチキャスト暗号アルゴリズム。 MulticastCipher メンバーのデータ型の詳細については、DOT11_CIPHER_ALGORITHM を参照してください。
ミニポート ドライバーは、uStatus が DOT11_ASSOCIATION_STATUS_SUCCESS に設定されていない場合、このメンバーを 0 に設定する必要があります。
uActivePhyListOffset
802.11 ステーションが BSS ネットワーク接続でパケットを送受信するために使用する PHY 識別子 (ID) のリストのオフセット。
Extensible Station (ExtSTA) msDot11ActivePhyList MIB オブジェクトは、アクティブな PHY リストも参照します。
この MIB オブジェクトの詳細については、OID_DOT11_ACTIVE_PHY_LISTを参照してください。
アクティブな PHY リストのエントリには、次のいずれかの値を指定できます。
- extSTA msDot11DesiredPhyList MIB オブジェクトで指定された PHY ID。 この MIB オブジェクトの詳細については、OID_DOT11_DESIRED_PHY_LISTを参照してください。
- DOT11_PHY_ID_ANY。 ミニポート ドライバーは、msDot11ActivePhyList MIB オブジェクトが、msDot11DesiredPhyList MIB オブジェクトで指定されているすべての PHY ID を指定する場合に、この値にエントリを設定できます。 DOT11_PHY_ID_ANYの値を持つエントリは、アクティブな PHY リスト内の唯一のエントリである必要があります。
アクティブな PHY リストのオフセットは、DOT11_ASSOCIATION_COMPLETION_PARAMETERS構造体を含むバッファーの先頭を基準とします。
ミニポート ドライバーは、uStatus が DOT11_ASSOCIATION_STATUS_SUCCESS に設定されていない場合、uActivePhyListOffsetと uActivePhyListSize メンバー 0 に設定する必要があります。
uActivePhyListSize
アクティブな PHY リストの長さ。
uActivePhyListSize メンバーは、sizeof(ULONG)
の倍数である必要があります。
bFourAddressSupported
TRUE に設定されている場合、802.11 ステーションが、モバイル ステーションや AP を含む BSS ネットワーク内の任意のステーションで ISO レイヤー 2 ブリッジングの配布システム (DS) サービスをサポートする AP に関連付けられていることを指定するブール値。 このサポートの決定は、IHV による実装に固有です。
ミニポート ドライバーは、次のいずれかが true の場合、bFourAddressSupported メンバーを FALSE 設定する必要があります。
- IEEE 802.11 dot11DesiredBSSType MIB オブジェクトは dot11_BSS_type_independentに設定されます。
- 802.11 ステーションは、DS サービスをサポートする AP に関連付けられなかったか、AP が DS サービスをサポートしているかどうかを判断できませんでした。
- uStatus メンバーがDOT11_ASSOCIATION_STATUS_SUCCESSに設定されていません。
bPortAuthorized
TRUE に設定されている場合、関連付け操作中に 802.11 ステーションが正常にポート承認を実行したことを指定するブール値。 ポート承認は、IEEE 802.1X/802.11i 標準または IHV によって開発された独自のアルゴリズムのいずれかに基づく場合があります。
ミニポート ドライバーは、bPortAuthorized 次のいずれかが true の場合、FALSE を に設定する必要があります。
- 802.11 ステーションはポート承認を実行しません。
- uStatus メンバーがDOT11_ASSOCIATION_STATUS_SUCCESSに設定されていません。
ポート承認の詳細については、「Port-Based ネットワーク アクセス」を参照してください。
ucActiveQoSProtocol
この関連付けに対して現在アクティブなサービス品質 (QoS) プロトコルを指定するフラグ。 このメンバーは、0 (QoS プロトコルがアクティブでないことを示します) または次のいずれかのフラグです。
DOT11_QOS_PROTOCOL_FLAG_WMM
NIC は 802.11 WMM QoS プロトコルを使用しています。
DOT11_QOS_PROTOCOL_FLAG_11E
NIC は 802.11e QoS プロトコルを使用しています。
DSInfo
802.11 ステーションが前の関連付け操作と同じ DS に接続されているかどうかを示すDOT11_DS_INFO値。
DSInfo メンバーは、次の値を指定するDOT11_DS_INFO列挙体として書式設定されます。
DOT11_DS_CHANGED
802.11 ステーションは、関連付け操作後に新しい DS に接続されています。
DOT11_DS_UNCHANGED
802.11 ステーションは、アソシエーション操作から同じ DS に接続されます。
DOT11_DS_UNKNOWN
ミニポート ドライバーは、関連付け操作後に DS が変更されたかどうかを判断できません。
手記
ミニポート ドライバーは 、dot11DesiredBSSType MIB オブジェクトが dot11_BSS_type_independentに設定されている場合、DSInfo を DOT11_DS_UNKNOWN に設定する必要があります。
uEncapTableOffset
BSS アソシエーションの IEEE EtherType カプセル化のリストのオフセット。
このオフセットは、DOT11_ASSOCIATION_COMPLETION_PARAMETERS構造体を含むバッファーの開始を基準にしています。 uEncapTableOffset の値は、4 バイト境界に配置する必要があります。
ミニポート ドライバーは、この一覧の各エントリを DOT11_ENCAP_ENTRY 構造として書式設定します。
EtherType カプセル化リストの詳細については、「802.11 Payload Encapsulation」を参照してください。
uEncapTableSize
EtherType カプセル化リストの長さ。
MulticastMgmtCipher
NIC が管理フレーム保護 (複合機) の関連付けに対して選択 (ネゴシエート) するマルチキャスト暗号アルゴリズム。 複合機がネゴシエートされた場合は、このメンバーをDOT11_CIPHER_ALGO_BIPする必要があります。 複合機がネゴシエートされない場合は、このフィールドをDOT11_CIPHER_ALGO_NONEする必要があります。
uAssocComebackTime
(再) 関連付けが 802.11 理由コード 30 で失敗した場合 ("関連付け要求は一時的に拒否されました。後で再試行してください。")、このメンバーは、アクセス ポイント (AP) によって要求された関連付けのカムバック時間の値を示します。 関連付け解除理由コード 802.11 は、関連付け要求に応答するときに、uStatus の最小 16 ビットに存在します。
Windows の自動接続サービスは、AP をブロックリストに追加し、少なくとも指定されたカムバック時間の再接続を試みません。 NIC は、次の接続シーケンスが開始されるまで、通常の失敗した認証のように動作します。 指定されたタイムアウト(カムバック)が経過し、接続プロセスが停止した後、Windows は、より良い代替接続を見つけるか、この接続への復帰を見つける可能性があります。 このメンバーに設定されたこの値は、802.11 仕様で定義されている時間単位を使用する必要があります。 たとえば、TU です。
備考
ミニポート ドライバーは、uEncapTableOffset を設定し、次のいずれかに該当する場合は uEncapTableSize メンバーを 0 に する必要があります。
- BSS 関連付けでは、オペレーティング システムの EtherType カプセル化の既定のリストを変更する必要はありません。
- uStatus メンバーがDOT11_ASSOCIATION_STATUS_SUCCESSに設定されていません。
- extensible Station (ExtSTA) dot11DesiredBSSType 管理情報ベース (MIB) オブジェクトは、dot11_BSS_type_independentに設定されます。
IEEE 802.11 dot11DesiredBSSType MIB オブジェクトの詳細については、OID_DOT11_DESIRED_BSS_TYPEを参照してください。
関連付け操作の詳細については、「関連付け操作の 」を参照してください。
管理フレーム保護は、アクセス ポイント (AP) と STA が (再) 関連付け手順 (つまり、AP のビーコンまたはプローブ応答と STA の (再) 関連付け要求) 中にそれぞれの RSN I で管理フレーム保護対応 (MFPC) フィールドを 1 に設定し、両方の当事者が 4 ウェイ ハンドシェイク (802.11i 4 ウェイ ハンドシェイクのメッセージ M2 および M3) で管理フレーム保護対応ビットが 1 に設定されていることを確認するとネゴシエートされます。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 8 以降のバージョンの Windows オペレーティング システムで使用できます。 |
ヘッダー | windot11.h (Ndis.h を含む) |
関連項目
NdisMIndicateStatusEx の