WiFi Framework
ContentsIndexHome
PreviousUpNext
TwclWiFiBss Record

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

Syntax
Pascal
TwclWiFiBss = record
  Ssid: string;
  PhyId: Cardinal;
  Mac: string;
  BssType: TwclWiFiBssType;
  PhyType: TwclWiFiPhy;
  Rssi: Integer;
  LinkQuality: Cardinal;
  InRegDomain: Boolean;
  BeaconPeriod: Word;
  Timestamp: UInt64;
  HostTimestamp: UInt64;
  Capability: TwclWiFiBssCaps;
  ChCenterFrequency: Cardinal;
  Rates: array of Word;
  IeRaw: array of Byte;
end;
Members 
Description 
Ssid: string; 
The SSID of the access point (AP) or peer station associated with the BSS.  
PhyId: Cardinal; 
The identifier (ID) of the PHY that the wireless LAN interface used to detect the BSS network.  
Mac: string; 
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.  
BssType: TwclWiFiBssType; 
The BSS network type. This member can be one of the following values: bssInfrastructure or bssIndependent.  
PhyType: TwclWiFiPhy; 
The PHY type for this network.  
Rssi: Integer; 
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.  
LinkQuality: Cardinal; 
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.  
InRegDomain: Boolean; 
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.
 
BeaconPeriod: Word; 
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.
 
Timestamp: UInt64; 
The value of the Timestamp field from the 802.11 Beacon or Probe Response frame received by the wireless LAN interface.  
HostTimestamp: UInt64; 
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.  
Capability: TwclWiFiBssCaps; 
The value of the Capability Information field from the 802.11 Beacon or Probe Response frame received by the wireless LAN interface.  
ChCenterFrequency: Cardinal; 
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).
 
Rates: array of Word; 
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
 
IeRaw: array of Byte; 
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.