DOT11_SCAN_REQUEST_V2構造体 (windot11.h)

[アーティクル]
03/08/2023

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

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 ステーションは完全なスキャンを実行することも、サポートされているチャネルのサブセットに対して部分スキャンを実行することもできます。

メモdot11_scan_type_forced ビットは、ミニポートドライバーが拡張可能ステーション (ExtSTA) モードで動作している場合にのみサポートされます。 dot11_scan_type_forced ビットは、DOT11_SCAN_TYPE値を持つビットごとの OR を介して設定する必要があります。

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

こちらもご覧ください

DOT11_PHY_TYPE_INFO

OID_DOT11_SCAN_REQUEST

次の方法で共有