DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS構造 (windot11.h)

[アーティクル]
02/27/2024

大事なネイティブ 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 ビーコンフレームの長さ (バイト単位)。

メモ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 を含む)