次の方法で共有


DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS構造 (windot11.h)

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

DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS構造体は、インフラストラクチャ BSS 上のピア ステーションからアソシエーション要求を受信した後に 802.11 ステーションによって実行される関連付け操作の結果を指定します。

構文

typedef struct _DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  DOT11_MAC_ADDRESS      PeerMacAddr;
  ULONG                  uStatus;
  UCHAR                  ucErrorSource;
  BOOLEAN                bReAssocReq;
  BOOLEAN                bReAssocResp;
  ULONG                  uAssocReqOffset;
  ULONG                  uAssocReqSize;
  ULONG                  uAssocRespOffset;
  ULONG                  uAssocRespSize;
  DOT11_AUTH_ALGORITHM   AuthAlgo;
  DOT11_CIPHER_ALGORITHM UnicastCipher;
  DOT11_CIPHER_ALGORITHM MulticastCipher;
  ULONG                  uActivePhyListOffset;
  ULONG                  uActivePhyListSize;
  ULONG                  uBeaconOffset;
  ULONG                  uBeaconSize;
} DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS, *PDOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS;

メンバー

Header

DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS構造体の型、リビジョン、およびサイズ。 このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

ミニポート ドライバーは 、ヘッダー のメンバーを次の値に設定する必要があります。

このメンバーは、NDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。

リビジョン

このメンバーは、DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS_REVISION_1に設定する必要があります。

サイズ

このメンバーは sizeof(DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS) に設定する必要があります。

これらのメンバーの詳細については、「 NDIS_OBJECT_HEADER」を参照してください。

PeerMacAddr

関連付け要求を送信したピア ステーションのメディア アクセス制御 (MAC) アドレス。

uStatus

ピア ステーションとの関連付けの状態。 0 の場合、関連付けは成功します。 0 以外の場合、関連付けは失敗します。

ucErrorSource

uStatus の 0 以外の値の場合、このメンバーは、関連付けを妨げるエラーの原因を示します。 NIC は ucErrorSource を次のいずれかの値に設定する必要があります。

DOT11_ASSOC_ERROR_SOURCE_OS

ミニポート ドライバーは、メモリ不足エラーなどのシステム エラーのため、関連付け手順を拒否しました。 この場合、 uStatus はオペレーティング システムから返されるNDIS_STATUS_XXXまたはNTSTATUS_XXXコードに設定する必要があります。

DOT11_ASSOC_ERROR_SOURCE_REMOTE

AP またはピア ステーションが関連付け手順を拒否しました。 この場合、 uStatus は、802.11 認証フレーム、関連付け応答フレーム、または再関連付け応答フレームを形成する 802.11 状態コードに設定する必要があります。 IEEE 802.11-2003 仕様の表 19 には、使用可能なすべての値が含まれています。 ミニポート ドライバーは、修正されたときに、この IEEE 仕様で新しい値を返すこともできます。

DOT11_ASSOC_ERROR_SOURCE_OTHER

IHV 固有の理由で関連付けに失敗しました。 この場合、 uStatus には IHV で指定された 0 以外の値が含まれます。

bReAssocReq

ピア ステーションからの要求が再関連付け要求であるかどうかを示すブール値。

bReAssocResp

NIC からの応答が再関連付け要求であるかどうかを示すブール値。

uAssocReqOffset

関連付け操作で使用される要求フレームのオフセット。 フレームには情報要素 (IEs) が含まれていますが、802.11 MAC ヘッダーは含まれません。

uAssocReqSize

関連付け操作で使用される要求フレームの長さ (バイト単位)。 フレームには情報要素 (IEs) が含まれていますが、802.11 MAC ヘッダーは含まれません。

uAssocRespOffset

関連付け操作で使用される応答フレームのオフセット。 フレームには情報要素 (IEs) が含まれていますが、802.11 MAC ヘッダーは含まれません。

uAssocRespSize

関連付け操作で使用される応答フレームの長さ (バイト単位)。 フレームには情報要素 (IEs) が含まれていますが、802.11 MAC ヘッダーは含まれません。

AuthAlgo

関連付け操作中に 802.11 ステーションがピア ステーションと解決した認証アルゴリズム。 AuthAlgo メンバーのデータ型の詳細については、「DOT11_AUTH_ALGORITHM」を参照してください。

メモuStatus が 0 に設定されていない場合、ミニポート ドライバーは、このメンバーを 0 に設定する必要があります。

UnicastCipher

関連付け操作中に 802.11 ステーションがピア ステーションと解決したユニキャスト暗号アルゴリズム。 UnicastCipher メンバーのデータ型の詳細については、「DOT11_CIPHER_ALGORITHM」を参照してください。

メモuStatus が 0 に設定されていない場合、ミニポート ドライバーは、このメンバーを 0 に設定する必要があります。

MulticastCipher

アソシエーション操作中に 802.11 ステーションが AP またはピア ステーションで解決したマルチキャスト暗号アルゴリズム。 MulticastCipher メンバーのデータ型の詳細については、「DOT11_CIPHER_ALGORITHM」を参照してください。

メモuStatus が 0 に設定されていない場合、ミニポート ドライバーは、このメンバーを 0 に設定する必要があります。

uActivePhyListOffset

802.11 ステーションが BSS ネットワーク接続のパケットの送受信に使用する PHY 識別子 (ID) のリストのオフセット。 各エントリは ULONG 値です。

Extensible Station (ExtSTA) msDot11ActivePhyList MIB objec は、アクティブな PHY リストも参照します。

アクティブ PHY リストのエントリには、次のいずれかの値を指定できます。

  • Extensible Station (ExtSTA) msDot11DesiredPhyList 管理情報ベース (MIB) オブジェクトによって指定される PHY ID。 この MIB オブジェクトの詳細については、「 OID_DOT11_DESIRED_PHY_LIST」を参照してください。
  • DOT11_PHY_ID_ANYの PHY ID。 ExtSTA msDot11ActivePhyList MIB オブジェクトが msDot11DesiredPhyList MIB オブジェクトで指定されているすべての PHY ID を指定している場合、ミニポート ドライバーはこの値 にエントリを 設定できます。 この MIB オブジェクトの詳細については、「 OID_DOT11_ACTIVE_PHY_LIST」を参照してください。
    メモ 値が DOT11_PHY_ID_ANY のエントリは、アクティブな PHY リスト内の唯一のエントリである必要があります。
アクティブな PHY リストのオフセットは、DOT11_ASSOCIATION_COMPLETION_PARAMETERS構造体を含むバッファーの先頭を基準にしています。
メモuStatus が 0 に設定されていない場合、ミニポート ドライバーは、このメンバーを 0 に設定する必要があります。

uActivePhyListSize

アクティブな PHY リストの長さ (バイト単位)。 uActivePhyListSize メンバーは、 のsizeof(ULONG)倍数である必要があります。

メモuStatus が 0 に設定されていない場合、ミニポート ドライバーは、このメンバーを 0 に設定する必要があります。

uBeaconOffset

最後に送信された 802.11 ビーコン フレームのオフセット (バイト単位)。

ビーコン フレームには、ビーコン フレーム ヘッダーとすべての情報要素 (IEs) が含まれますが、802.11 MAC ヘッダーは含まれません。 ビーコン フレーム形式は ISO/IEC 8802-11 で定義されています。

ビーコン フレームは、データ フレーム フロー制御によって異なるリアルタイム パラメーターまたは IEs、またはタイムスタンプ、無線パラメーター、TIM、ERP、HT IEs などのクライアント関連付けの状態が正確である必要がない点を除き、ドライバーによって使用される最新のフレームである必要があります。

メモuStatus が 0 に設定されていない場合、ミニポート ドライバーは、このメンバーを 0 に設定する必要があります。

uBeaconSize

最後に送信された 802.11 ビーコン フレームの長さ (バイト単位)。

ビーコン フレームには、ビーコン フレーム ヘッダーとすべての情報要素 (IEs) が含まれますが、802.11 MAC ヘッダーは含まれません。 ビーコン フレーム形式は ISO/IEC 8802-11 で定義されています。

ビーコン フレームは、データ フレーム フロー制御によって異なるリアルタイム パラメーターまたは IEs、またはタイムスタンプ、無線パラメーター、TIM、ERP、HT IEs などのクライアント関連付けの状態が正確である必要がない点を除き、ドライバーによって使用される最新のフレームである必要があります。

メモuStatus が 0 に設定されていない場合、ミニポート ドライバーは、このメンバーを 0 に設定する必要があります。

注釈

ネイティブ 802.11 ミニポート ドライバーには、ドライバーが を行うときにDOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS構造が含まれています。 NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION 状態を示します。

NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION状態表示は、 アソシエーション表示ブロックの終了を示します。 関連付けが成功した場合、NIC は、最初に関連付けを要求したステーションに対応するアソシエーション応答フレームを正常に送信した後、NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETIONを示す必要があります。 関連付けに失敗した場合、NIC は応答が正常に送信されたかどうかを示すNDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETIONを行う必要があります。 このエラーは、NIC またはオペレーティング システムがアソシエーション要求を拒否したか、802.11 フレームワークに関連しないエラーが原因である可能性があります。

要件

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

こちらもご覧ください

DOT11_AUTH_ALGORITHM

NDIS_STATUS_DOT11_INCOMING_ASSOC_COMPLETION

DOT11_CIPHER_ALGORITHM

NDIS_OBJECT_HEADER