WiFi Framework
ContentsIndexHome
PreviousUpNext
wclWiFi::wclWiFiBss Structure

The record contains information about a basic service set (BSS).

Syntax
C++
typedef struct {
  tstring Ssid;
  unsigned long PhyId;
  tstring Mac;
  wclWiFiBssType BssType;
  wclWiFiPhy PhyType;
  int Rssi;
  unsigned long LinkQuality;
  bool InRegDomain;
  unsigned short BeaconPeriod;
  unsigned long long Timestamp;
  unsigned long long HostTimestamp;
  wclWiFiBssCaps Capability;
  unsigned long ChCenterFrequency;
  std::vector<unsigned short> Rates;
  std::vector<unsigned char> IeRaw;
} wclWiFiBss;
Members 
Description 
tstring Ssid; 
The SSID of the access point (AP) or peer station associated with the BSS.  
unsigned long PhyId; 
The identifier (ID) of the PHY that the wireless LAN interface used to detect the BSS network.  
tstring Mac; 
The media access control (MAC) address of the access point for infrastructure BSS networks or the peer station for independent BSS networks (ad hoc networks) that sent the 802.11 Beacon or Probe Response frame received by the wireless LAN interface while scanning.  
wclWiFiBssType BssType; 
The BSS network type. This member can be one of the following values: bssInfrastructure or bssIndependent.  
wclWiFiPhy PhyType; 
The PHY type for this network.  
int Rssi; 
The received signal strength indicator (RSSI) value, in units of decibels referenced to 1.0 milliwatts (dBm), as detected by the wireless LAN interface driver for the AP or peer station.  
unsigned long LinkQuality; 
The link quality reported by the wireless LAN interface driver. The link quality value ranges from 0 through 100. A value of 100 specifies the highest link quality.  
bool InRegDomain; 
A value that specifies whether the AP or peer station is operating within the regulatory domain as identified by the country/region.
If the wireless LAN interface driver does not support multiple regulatory domains, this member is set to True.
If the 802.11 Beacon or Probe Response frame received from the AP or peer station does not include a Country information element (IE), this member is set to True.
If the 802.11 Beacon or Probe Response frame received from the AP or peer station does include a Country IE, this member is set to False if the value of the Country String subfield does not equal the input country string.
 
unsigned short BeaconPeriod; 
The value of the Beacon Interval field from the 802.11 Beacon or Probe Response frame received by the wireless LAN interface.
The interval is in 1.024 microsecond time units between target beacon transmission times. This information is retrieved from the beacon packet sent by an access point in an infrastructure BSS network or a probe response from an access point or peer station in response to a wireless LAN client sending a Probe Request.
The IEEE 802.11 standard defines a unit of time as equal to 1.024 microseconds. This unit was defined so that it could be easily implemented in hardware.
 
unsigned long long Timestamp; 
The value of the Timestamp field from the 802.11 Beacon or Probe Response frame received by the wireless LAN interface.  
unsigned long long HostTimestamp; 
The host timestamp value that records when wireless LAN interface received the Beacon or Probe Response frame. This member is a count of 100-nanosecond intervals since January 1, 1601.  
wclWiFiBssCaps Capability; 
The value of the Capability Information field from the 802.11 Beacon or Probe Response frame received by the wireless LAN interface.  
unsigned long ChCenterFrequency; 
The channel center frequency of the band on which the 802.11 Beacon or Probe Response frame was received. The value of ChCenterFrequency is in units of kilohertz (kHz).
This member is only valid for PHY types that are not frequency-hopping spread spectrum (FHSS).
 
std::vector<unsigned short> Rates; 
An array of supported data transfer rates.
Each supported data transfer rate is stored as a Word. The first bit of the Word specifies whether the rate is a basic rate. A basic rate is the data transfer rate that all stations in a basic service set (BSS) can use to receive frames from the wireless medium. If the rate is a basic rate, the first bit of the Word is set to 1.
To calculate the data transfer rate in Mbps for an arbitrary array entry Rates[i], use the following equation:
rate_in_mbps = (Rates[i] and $7FFF) * 0.5
 
std::vector<unsigned char> IeRaw; 
This member contains variable-length information elements (IEs) bytes array from the 802.11 Beacon or Probe Response frames. For each BSS, the IEs are from the last Beacon or Probe Response frame received from that BSS network. If an IE is available in only one frame, the wireless LAN interface driver merges the IE with the other IEs from the last received Beacon or Probe Response frame.
Information elements are defined in the IEEE 802.11 specifications to have a common general format consisting of a 1-byte Element ID field, a 1-byte Length field, and a variable-length element-specific information field. Each information element is assigned a unique Element ID value as defined in this IEEE 802.11 standards. The Length field specifies the number of bytes in the information field.
 
Copyright (c) 2006-2019. All rights reserved.