DOT11_SCAN_REQUEST_V2構造体 (windot11.h)
DOT11_SCAN_REQUEST_V2構造体は、802.11 ステーションによって実行される明示的なスキャン操作のパラメーターを定義します。 ステーションは、OID_DOT11_SCAN_REQUESTの OID セット要求の後に明示的なスキャン操作 を実行します。
構文
typedef struct _DOT11_SCAN_REQUEST_V2 {
DOT11_BSS_TYPE dot11BSSType;
DOT11_MAC_ADDRESS dot11BSSID;
DOT11_SCAN_TYPE dot11ScanType;
BOOLEAN bRestrictedScan;
ULONG udot11SSIDsOffset;
ULONG uNumOfdot11SSIDs;
BOOLEAN bUseRequestIE;
ULONG uRequestIDsOffset;
ULONG uNumOfRequestIDs;
ULONG uPhyTypeInfosOffset;
ULONG uNumOfPhyTypeInfos;
ULONG uIEsOffset;
ULONG uIEsLength;
UCHAR ucBuffer[1];
} DOT11_SCAN_REQUEST_V2, *PDOT11_SCAN_REQUEST_V2;
メンバー
dot11BSSType
802.11 ステーションがスキャンする基本的なサービス セット (BSS) ネットワークの種類。 このメンバーのデータ型は 、DOT11_BSS_TYPE 列挙型です。
dot11BSSID
802.11 ステーションがスキャンする BSS ネットワークの BSS 識別子 (BSSID)。 このメンバーがワイルドカード BSSID (0xFFFFFFFFFFFF) に設定されている場合、ステーションはすべての BSSID をスキャンします。
dot11ScanType
802.11 ステーションが実行するスキャンの種類。 このメンバーのデータ型は、次の値を宣言するDOT11_SCAN_TYPE列挙です。
dot11_scan_type_active
ステーションは、スキャンする各チャネルで 802.11 プローブ要求フレームを送信します。 プローブ要求に対して 802.11 プローブ応答フレームを受信するのに十分な長さがあるチャネルに住んでいます。 ステーションは、チャネルで送信された 802.11 ビーコン フレームも受信します。
dot11_scan_type_passive
ステーションは、スキャンする各チャネルで 802.11 プローブ要求フレームを送信しません。 代わりに、チャネルで送信された 802.11 ビーコンまたはプローブ要求フレームを受信します。
dot11_scan_type_auto
ステーションは、アクティブまたはパッシブ スキャンを実行することも、両方のスキャンの種類を組み合わせて使用することもできます。
dot11ScanType の値に関係なく、802.11 ステーションは、現在の規制ドメインで無効なチャネルをスキャンするたびに、スキャンの種類のdot11_scan_type_passiveを実行する必要があります。 また、802.11 ステーションに既定の規制ドメインがない場合は 、スキャンの種類のdot11_scan_type_passive を実行する必要があります。 規制ドメインの詳細については、「 OID_DOT11_CURRENT_REG_DOMAIN」を参照してください。
dot11_scan_type_forced ビットが dot11ScanType メンバーに設定されている場合、802.11 ステーションは、サポートされているすべてのチャネルで完全スキャンを実行する必要があります。 dot11_scan_type_forced ビットが設定されていない場合、802.11 ステーションは完全なスキャンを実行することも、サポートされているチャネルのサブセットに対して部分スキャンを実行することもできます。
bRestrictedScan
このメンバーが TRUE の場合、802.11 ステーションは、BSS ネットワークへの接続に使用されるチャネルと PHY 構成に制限されたスキャンを実行します。
ミニポート ドライバーは、次のいずれかが当てはまる場合、このメンバーを無視する必要があります。
- ミニポート ドライバーが ExtSTA モードで動作しています。
- 802.11 ステーションは BSS ネットワークに接続されていません。
udot11SSIDsOffset
サービス セット識別子 (SSID) リストが開始される ucBuffer 配列内のオフセット。 SSID リスト内の各エントリは、 DOT11_SSID 構造として書式設定されます。
802.11 ステーションは、リスト内の各 SSID をスキャンします。 たとえば、 dot11ScanType が dot11_scan_type_active に設定されている場合、802.11 ステーションは、チャネルでのスキャン中にリスト内の各 SSID に対して 802.11 プローブ要求を送信します。
uNumOfdot11SSIDs
SSID リスト内のエントリの数。
uNumOfdot11SSIDs が 0 の場合、ミニポート ドライバーはワイルドカードの長さ 0 の SSID を含む SSID リストを使用する必要があります。
bUseRequestIE
このメンバーが TRUE の場合、802.11 ステーションには、アクティブ スキャン中に送信される各プローブ要求フレームの 802.11d 要求情報要素 (IE) 内の要求 ID の一覧 ( uRequestIDsOffset メンバーと uNumOfRequestIDs メンバーを介して定義) が含まれている必要があります。
ミニポート ドライバーは、次のいずれかが当てはまる場合は、このメンバー ( uRequestIDsOffset および uNumOfRequestIDs メンバーと共に) を無視する必要があります。
- ミニポート ドライバーが ExtSTA モードで動作しています。
- 802.11 dot11MultiDomainCapabilityEnabled 管理情報ベース (MIB) オブジェクトは FALSE です。 dot11MultiDomainCapabilityEnabled MIB オブジェクトの詳細については、次を参照してください。 OID_DOT11_MULTI_DOMAIN_CAPABILITY_ENABLED。
- dot11ScanType メンバーは、dot11_scan_type_passiveに設定されます。
uRequestIDsOffset
要求 ID リストが開始される ucBuffer 配列内のオフセット。 要求 ID リストの各エントリは、UCHAR データ型として書式設定されます。
uNumOfRequestIDs
要求 ID リスト内のエントリの数。
uPhyTypeInfosOffset
PHY 型のリストが始まる ucBuffer 配列内のオフセット。 PHY タイプのリスト内の各項目は、 DOT11_PHY_TYPE_INFO 構造としてフォーマットされます。
802.11 ステーションは、このリストから指定された PHY タイプをそれぞれ使用して BSS スキャンを実行する必要があります。
bRestrictedScan が TRUE に設定されている場合、ミニポート ドライバーは (uNumOfPhyTypeInfos メンバーと共に) このメンバーを無視する必要があります。
uNumOfPhyTypeInfos
PHY タイプのリスト内のエントリの数。
uNumOfPhyTypeInfos が 0 の場合、802.11 ステーションは、サポートされているすべての PHY を使用してスキャンを実行します。
uIEsOffset
可変長情報要素 (IEs) のリストが始まる ucBuffer 配列内のオフセット。 802.11 ステーションは、アクティブ スキャン中に送信する各プローブ要求フレームの末尾に、IEs のリストを追加する必要があります。
dot11ScanType がdot11_scan_type_passiveに設定されている場合、ミニポート ドライバーは (uIEsLength メンバーと共に) このメンバーを無視する必要があります。
uIEsLength
IDE の一覧の長さ (バイト単位)。
ucBuffer[1]
この構造体の他のメンバーによって指定されたオプションのデータを含むバッファー。
注釈
802.11 ステーションは、OID_DOT11_SCAN_REQUESTの OID セット要求に従って明示的なスキャン操作 を実行します。 ステーションは、set 要求に付随するDOT11_SCAN_REQUEST_V2で定義されたパラメーターを使用してスキャン操作を実行します。
Native 802.11 ミニポート ドライバーによって実行されるスキャン操作の詳細については、「 Native 802.11 スキャン操作」を参照してください。
ExtSTA 操作モードの詳細については、「 拡張ステーション操作モード」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| Header | windot11.h (Ndis.h を含む) |