DOT11_INCOMING_ASSOC_COMPLETION_PARAMETERS構造体 (windot11.h)
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を参照してください。
UnicastCipher
関連付け操作中に 802.11 ステーションがピア ステーションで解決したユニキャスト暗号アルゴリズム。 ユニキャストCipher メンバーのデータ型の詳細については、DOT11_CIPHER_ALGORITHMを参照してください。
MulticastCipher
アソシエーション操作中に 802.11 ステーションが AP またはピア ステーションで解決したマルチキャスト暗号アルゴリズム。 MulticastCipher メンバーのデータ型の詳細については、DOT11_CIPHER_ALGORITHMを参照してください。
uActivePhyListOffset
802.11 ステーションが BSS ネットワーク接続でパケットを送受信するために使用する PHY 識別子 (ID) のリストのオフセット。 各エントリは ULONG 値です。
extensible Station (ExtSTA) msDot11ActivePhyList MIB オブジェクトもアクティブな PHY リストを参照します。
アクティブな PHY リストのエントリには、次のいずれかの値を指定できます。
- msDot11DesiredPhyList 管理情報ベース (MIB) オブジェクト 拡張ステーション (ExtSTA) で指定された 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を参照してください。
注 アクティブな PHY リストの唯一のエントリは、DOT11_PHY_ID_ANYの値を持つエントリである必要があります。
uActivePhyListSize
アクティブな PHY リストの長さ (バイト単位)。
uActivePhyListSize メンバーは、sizeof(ULONG)の倍数である必要があります。
uBeaconOffset
最後に送信された 802.11 ビーコン フレームのオフセット (バイト単位)。
ビーコン フレームにはビーコン フレーム ヘッダーとすべての情報要素 (IEs) が含まれていますが、802.11 MAC ヘッダーは含まれません。 ビーコン フレーム形式は ISO/IEC 8802-11 で定義されています。
ビーコン フレームは、データ フレーム フロー制御によって変化するリアルタイム パラメーターまたは IE、またはタイムスタンプ、無線パラメーター、TIM、ERP、HT IE などのクライアント関連付け状態が正確である必要がない点を除き、ドライバーで使用される最新のフレームにする必要があります。
uBeaconSize
最後に送信された 802.11 ビーコン フレームの長さ (バイト単位)。
ビーコン フレームにはビーコン フレーム ヘッダーとすべての情報要素 (IEs) が含まれていますが、802.11 MAC ヘッダーは含まれません。 ビーコン フレーム形式は ISO/IEC 8802-11 で定義されています。
ビーコン フレームは、データ フレーム フロー制御によって変化するリアルタイム パラメーターまたは IE、またはタイムスタンプ、無線パラメーター、TIM、ERP、HT IE などのクライアント関連付け状態が正確である必要がない点を除き、ドライバーで使用される最新のフレームにする必要があります。
備考
ネイティブ 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 オペレーティング システムで使用できます。 |
| ヘッダー | windot11.h (Ndis.h を含む) |