WLAN_BSS_ENTRY 構造体 (wlanapi.h)
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 列挙値です。
このメンバーには、次のいずれかの値を指定できます。
| 値 | 意味 |
|---|---|
|
インフラストラクチャ BSS ネットワークを指定します。 |
|
独立した 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 つ以上を指定できます。
ulChCenterFrequency
802.11 ビーコンまたはプローブ応答フレームを受信したバンドのチャネル中心周波数。 ulChCenterFrequency の値は、キロヘルツ (kHz) 単位です。
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 |