WLAN_BSS_ENTRY 構造体 (wlanapi.h)

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

WLAN_BSS_ENTRY構造体には、基本的なサービスセット (BSS) に関する情報が含まれています。

構文

typedef struct _WLAN_BSS_ENTRY {
  DOT11_SSID        dot11Ssid;
  ULONG             uPhyId;
  DOT11_MAC_ADDRESS dot11Bssid;
  DOT11_BSS_TYPE    dot11BssType;
  DOT11_PHY_TYPE    dot11BssPhyType;
  LONG              lRssi;
  ULONG             uLinkQuality;
  BOOLEAN           bInRegDomain;
  USHORT            usBeaconPeriod;
  ULONGLONG         ullTimestamp;
  ULONGLONG         ullHostTimestamp;
  USHORT            usCapabilityInformation;
  ULONG             ulChCenterFrequency;
  WLAN_RATE_SET     wlanRateSet;
  ULONG             ulIeOffset;
  ULONG             ulIeSize;
} WLAN_BSS_ENTRY, *PWLAN_BSS_ENTRY;

メンバー

dot11Ssid

BSS に関連付けられているアクセスポイント (AP) またはピアステーションの SSID。このメンバーのデータ型は、DOT11_SSID 構造体です。

uPhyId

ワイヤレス LAN インターフェイスが BSS ネットワークを検出するために使用した PHY の識別子 (ID)。

dot11Bssid

スキャン中にワイヤレス LAN インターフェイスによって受信された 802.11 ビーコンまたはプローブ応答フレームを送信した、インフラストラクチャ BSS ネットワークまたは独立した BSS ネットワーク (アドホックネットワーク) のピアステーションのアクセスポイントのメディアアクセス制御 (MAC) アドレス。このメンバーのデータ型は、DOT11_MAC_ADDRESS 構造体です。

dot11BssType

BSS ネットワークの種類。このメンバーのデータ型は、DOT11_BSS_TYPE 列挙値です。

このメンバーには、次のいずれかの値を指定できます。

値	意味
dot11_BSS_type_infrastructure 1	インフラストラクチャ BSS ネットワークを指定します。
dot11_BSS_type_independent 2	独立した BSS (IBSS) ネットワーク (アドホックネットワーク) を指定します。

dot11BssPhyType

このネットワークの PHY の種類。このメンバーのデータ型は、DOT11_PHY_TYPE 列挙値です。

lRssi

AP またはピアステーションのワイヤレス LAN インターフェイスドライバーによって検出された、1.0 ミリワット (dBm) を参照するデシベル単位の受信信号強度インジケーター (RSSI) 値。

uLinkQuality

ワイヤレス LAN インターフェイスドライバーによって報告されるリンク品質。リンク品質の値の範囲は 0 ~ 100 です。値 100 は、最高のリンク品質を指定します。

bInRegDomain

国/地域によって識別される規制ドメイン内で AP ステーションまたはピアステーションが動作しているかどうかを示す値です。

ワイヤレス LAN インターフェイスドライバーが複数の規制ドメインをサポートしていない場合、このメンバーは TRUE に設定されます。

AP またはピアステーションから受信した 802.11 ビーコンまたはプローブ応答フレームに Country information 要素 (IE) が含まれていない場合、このメンバーは TRUE に設定されます。

AP またはピアステーションから受信した 802.11 ビーコンまたはプローブ応答フレームに Country IE が含まれている場合、Country String サブフィールドの値が入力国文字列と等しくない場合、このメンバーは FALSE に 設定されます。

usBeaconPeriod

ワイヤレス LAN インターフェイスによって受信された 802.11 ビーコンまたはプローブ応答フレームからのビーコン間隔フィールドの値。

この間隔は、ターゲットビーコン送信時間の間の 1,024 マイクロ秒の時間単位です。この情報は、インフラストラクチャ BSS ネットワーク内のアクセスポイントによって送信されたビーコンパケット、またはプローブ要求を送信するワイヤレス LAN クライアントへの応答として、アクセスポイントまたはピアステーションからのプローブ応答から取得されます。

IEEE 802.11 標準では、時間の単位が 1,024 マイクロ秒と定義されています。このユニットは、ハードウェアに簡単に実装できるように定義されています。

ullTimestamp

ワイヤレス LAN インターフェイスによって受信された 802.11 ビーコンまたはプローブ応答フレームの Timestamp フィールドの値。

ullHostTimestamp

ワイヤレス LAN インターフェイスがビーコンまたはプローブ応答フレームを受信したときに記録するホストタイムスタンプ値。このメンバーは、1601 年 1 月 1 日以降の 100 ナノ秒間隔のカウントです。

詳細については、WDK に記載されている NdisGetCurrentSystemTime 関数を参照してください。

usCapabilityInformation

ワイヤレス LAN インターフェイスによって受信された 802.11 ビーコンまたはプローブ応答フレームの [機能情報] フィールドの値。この値は、機能を定義するビットフラグのセットです。

このメンバーには、次の値の 1 つ以上を指定できます。

値	意味
Ess ビット 0	拡張サービスセット。 1 つ以上の相互接続された基本サービスセット (BSS) と統合ローカルエリアネットワーク (LAN) のセット。これらの BSS のいずれかに関連付けられている任意のステーションの論理リンク制御レイヤーへの単一の BSS として表示されます。 AP は ESS サブフィールドを 1 に設定し、IBSS サブフィールドを送信されたビーコンまたはプローブ応答フレーム内で 0 に設定します。 IBSS (アドホックネットワーク) 内のピアステーションは、送信されたビーコンまたはプローブ応答フレームで ESS サブフィールドを 0 に、IBSS サブフィールドを 1 に設定します。
Ibss ビット 1	独立した基本サービスセット。自己完結型ネットワークを形成し、配布システム (DS) へのアクセスが利用できない BSS (アドホックネットワーク)。 AP は ESS サブフィールドを 1 に、IBSS サブフィールドを送信されたビーコンまたはプローブ応答フレーム内で 0 に設定します。 IBSS (アドホックネットワーク) 内のピアステーションは、送信されたビーコンまたはプローブ応答フレームで ESS サブフィールドを 0 に、IBSS サブフィールドを 1 に設定します。
CF-Pollable ビット 2	AP またはピアステーションがポーリング可能かどうかを示す値。
CF ポーリング要求ビット 3	AP またはピアステーションがポーリング要求を処理する方法を示す値。
プライバシービット 4	すべてのデータフレームに暗号化が必要かどうかを示す値。 BSS 内で交換されるすべてのデータ型フレームに WEP、WPA、または WPA2 暗号化が必要な場合、AP は送信されたビーコンおよびプローブ応答フレーム内でプライバシーサブフィールドを 1 に設定します。 WEP、WPA、または WPA2 暗号化が不要な場合、Privacy サブフィールドは 0 に設定されます。 IBSS 内で交換されるすべてのデータ型フレームに WEP、WPA、または WPA2 暗号化が必要な場合、IBSS 内のピアステーションは、送信されたビーコンおよびプローブ応答フレーム内のプライバシーサブフィールドを 1 に設定します。 WEP、WPA、または WPA2 暗号化が不要な場合、Privacy サブフィールドは 0 に設定されます。

ulChCenterFrequency

802.11 ビーコンまたはプローブ応答フレームを受信したバンドのチャネル中心周波数。 ulChCenterFrequency の値は、キロヘルツ (kHz) 単位です。

メモこのメンバーは、周波数ホッピング拡散スペクトル (FHSS) ではない PHY タイプに対してのみ有効です。

wlanRateSet

BSS でサポートされている一連のデータ転送レート。このメンバーのデータ型は、WLAN_RATE_SET 構造体です。

ulIeOffset

WLAN_BSS_ENTRY構造体の先頭からの情報要素 (IE) データ BLOB のオフセット (バイト単位)。

このメンバーは、802.11 ビーコンまたはプローブ応答フレームからの可変長情報要素 (IEs) を含むバッファーを指します。各 BSS について、その BSS ネットワークから受信した最後のビーコンまたはプローブ応答フレームからの IEs です。 IE が 1 つのフレームでのみ使用できる場合、ワイヤレス LAN インターフェイスドライバーは、最後に受信したビーコンまたはプローブ応答フレームの他の IEs と IE をマージします。

情報要素は、IEEE 802.11 仕様で定義され、1 バイトの要素 ID フィールド、1 バイトの Length フィールド、可変長要素固有の情報フィールドで構成される共通の一般的な形式を持ちます。各情報要素には、この IEEE 802.11 標準で定義されている一意の要素 ID 値が割り当てられます。 [長さ] フィールドでは、情報フィールドのバイト数を指定します。

ulIeSize

WLAN_BSS_ENTRY構造体内の IE データ BLOB のサイズ (バイト単位)。

これは 、ulIeOffset メンバーが指すバッファー内のデータの正確な長さであり、配置用のパディングは含まれません。 IE データ BLOB のサイズの最大値は 2,324 バイトです。

注釈

WlanGetNetworkBssList 関数は、特定のインターフェイス上のワイヤレスネットワークまたはネットワークの BSS リストを取得し、の配列を含むWLAN_BSS_LIST構造体でこの情報を返します。WLAN_BSS_ENTRY構造体。

ワイヤレス LAN インターフェイスがワイヤレスホステッドネットワークとしても動作している場合、BSS リストには、ワイヤレスホステッドネットワーク用に作成された BSS のエントリが含まれます。

情報はインフラストラクチャ BSS ネットワークのアクセスポイントまたは独立した BSS ネットワーク (アドホックネットワーク) のネットワークピアによって返されるため、返される情報は信頼できません。 WLAN_BSS_ENTRY構造体の ulIeOffset メンバーと ulIeSize メンバーを使用して、情報要素データ BLOB のデータではなく、WLAN_BSS_ENTRY構造体内の情報要素データ BLOB の最大サイズを決定する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
Header	wlanapi.h

こちらもご覧ください

WLAN_AVAILABLE_NETWORK

WLAN_AVAILABLE_NETWORK_LIST

WLAN_BSS_LIST

WlanGetAvailableNetworkList

WlanGetNetworkBssList

Share via

WLAN_BSS_ENTRY 構造体 (wlanapi.h)

構文

メンバー

注釈

要件

こちらもご覧ください

フィードバック

フィードバック

その他のリソース