DOT11_ASSOCIATION_COMPLETION_PARAMETERS構造 (windot11.h)

  • [アーティクル]

重要

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

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) (インフラストラクチャ BSS ネットワークの場合) またはピア ステーション (独立 BSS (IBSS) ネットワークの場合) のメディア アクセス制御 (MAC) アドレス。

uStatus

関連付け操作の完了状態 。 DOT11_ASSOC_STATUSに対して定義された値によって指定されます。

bReAssocReq

802.11 ステーションが 802.11 関連付けフレームまたは再関連付けフレームを AP に送信したかどうかを示すブール値。 TRUE の場合、802.11 ステーションは 801.11 再関連付け要求フレームを AP に送信します。 FALSE の場合、802.11 ステーションは 802.11 アソシエーション要求フレームを AP に送信します。

bReAssocReq メンバーの値 TRUE は、dot11DesiredBSSType MIB オブジェクトがdot11_BSS_type_infrastructureに設定されている場合にのみ有効です。

bReAssocResp

802.11 ステーションが AP から 802.11 関連付けフレームまたは再関連付けフレームを受信したかどうかを示すブール値。 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 ビーコンまたはプローブ応答フレームのオフセット。 ミニポート ドライバーは、 NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION 状態を示すときに、これらのフレームの 802.11 MAC ヘッダーを除外する必要があります。

このオフセットは、DOT11_ASSOCIATION_COMPLETION_PARAMETERS構造体を含むバッファーの先頭に対する相対位置です。

注意

 関連付けに使用される認証アルゴリズムが保護アクセス (WPA) または IEEE 802.11i 堅牢セキュリティ ネットワーク関連付け (RSNA) Wi-Fi された場合、ミニポート ドライバーは常に最後に受信した 802.11 ビーコン フレームを返す必要があり、 uBeaconOffset メンバーと uBeaconSize メンバーを 0 に設定しないでください。

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 による実装に固有です。

ミニポート ドライバーは、次のいずれかに該当する場合、 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 によって開発された独自のアルゴリズムに基づく可能性があります。

ミニポート ドライバーは、次のいずれかに該当する場合は、false に bPortAuthorized を設定する必要があります。

  • 802.11 ステーションはポート認可を実行しません。
  • uStatus メンバーが DOT11_ASSOCIATION_STATUS_SUCCESS に設定されていません。

ポート承認の詳細については、「 ポート ベースのネットワーク アクセス」を参照してください。

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 ペイロード カプセル化」を参照してください。

uEncapTableSize

EtherType カプセル化リストの長さ。

MulticastMgmtCipher

NIC が管理フレーム保護 (複合機) の関連付けに対して選択 (ネゴシエート) するマルチキャスト暗号アルゴリズム。 複合機がネゴシエートされた場合は、このメンバーをDOT11_CIPHER_ALGO_BIPする必要があります。 複合機がネゴシエートされていない場合は、このフィールドをDOT11_CIPHER_ALGO_NONEする必要があります。

uAssocComebackTime

(再) 関連付けが 802.11 理由コード 30 で失敗した場合 ("関連付け要求は一時的に拒否されました。後でもう一度やり直してください")、このメンバーは、アクセス ポイント (AP) によって要求された関連付けのカムバック時間の値を示します。 関連付け要求に応答するときに、802.11 の関連付け解除理由コードが最も低い 16 ビットの uStatus に存在します。

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 IE で管理フレーム保護対応 (MFCC) フィールドを 1 に設定し、両方の当事者が 4 ウェイ ハンドシェイク (802.11i 4 ウェイ ハンドシェイクのメッセージ M2 と M3) で管理フレーム保護対応ビットが 1 に設定されていることを確認するとネゴシエートされます。

要件

要件 値
サポートされている最小のクライアント Windows 8以降のバージョンの Windows オペレーティング システムで使用できます。
Header windot11.h (Ndis.h を含む)

こちらもご覧ください

DOT11_ENCAP_ENTRY

DOT11_ASSOC_STATUS

NdisMIndicateStatusEx

DOT11_AUTH_ALGORITHM

OID_DOT11_ACTIVE_PHY_LIST

DOT11_CIPHER_ALGORITHM

DOT11_MAC_ADDRESS

OID_DOT11_DESIRED_PHY_LIST

OID_DOT11_DESIRED_BSS_TYPE

NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION

NDIS_OBJECT_HEADER