WRAPI Documentation

WRAPI Datatypes

WRAPI_NDIS_DEVICE

The WRAPI_NDIS_DEVICE structure stores information about each NDIS miniport device in the system. Each structure corresponds to a physical network adapter, e.g. WLAN, Ethernet, etc.

typedef struct {
   WCHAR*		pDeviceName;
   WCHAR*	pDeviceDescription;
} WRAPI_NDIS_DEVICE;

DOT_11_CONFIGURATION

The DOT_11_CONFIGURATION structure stores all the radio configuration parameters of the 802.11 card. BeaconPeriod specifies the interval between beacon message transmissions. This value is specified in KÁsec (1024 Ásec).
typedef struct {
   ULONG				Length;
   ULONG				BeaconPeriod;
   ULONG				ATIMWindow;
   ULONG				DSConfig;
   NDIS_802_11_CONFIGURATION_FH	FHConfig;
} DOT_11_CONFIGURATION, *PDOT_11_CONFIGURATION;

Members

Length
Specifies the length of the DOT_11_CONFIGURATION structure in bytes
BeaconPeriod
Specifies the interval between beacon message transmissions. This value is specified in KÁsec (1024 Ásec).
ATIMWindow
Specifies the length of the ATIM window in KÁsec (1024 Ásec). The ATIM window is a short time period immediately following the transmission of each beacon in an IBSS configuration. During the ATIM window, any station can indicate the need to transfer data to another station during the following data transmission window.
DSConfig
Specifies the frequency of the selected channel in kHz.
FHConfig
Specifies the frequency-hopping configuration in an NDIS_802_11_CONFIGURATION structure.

DOT_11_STATS

The DOT_11_STATS structure describes all the packet-level statistics of the 802.11 interface. The detailed structure shown below indicates all the fields.
typedef struct {
   LARGE_INTEGER		TransmittedFragmentCount;
   LARGE_INTEGER		MulticastTransmittedFrameCount;
   LARGE_INTEGER		FailedCount;
   LARGE_INTEGER		RetryCount;
   LARGE_INTEGER		MultipleRetryCount;
   LARGE_INTEGER		RTSSuccessCount;
   LARGE_INTEGER		RTSFailureCount;
   LARGE_INTEGER		ACKFailureCount;
   LARGE_INTEGER		FrameDuplicateCount;
   LARGE_INTEGER		ReceivedFragmentCount;
   LARGE_INTEGER		MulticastReceivedFrameCount;
   LARGE_INTEGER		FCSErrorCount;
} DOT_11_STATS, *PDOT_11_STATS;

MAC_ADDR

Use the MAC_ADDR data type to store the 48 bit MAC address in an array of unsigned chars. This allows for easy operations like comparison, deletion, copying on MAC address.

typedef u8 MAC_ADDR[6];

SIG_STRENGTH

The SIG_STRENGTH datatype is a 32-bit integer that stores the Rssi value in dBm.

typedef UINT32 SIG_STRENGTH;

AP_DATA

The AP_DATA structure stores the value of the Base Service Set Identifier (BSSI), which consists of the MAC address and signal strength for each access point. The BSSI list consists of an array of BSSI, which will be represented by an array of AP_DATA structures.

typedef struct {
   MAC_ADDR 	mac_addr;
   SIG_STRENGTH	Rssi;
} AP_DATA;

Requirements

  Windows XP
  Windows 95/98/Me: Unsupported.
  Header: Declared in WRAPIExports.h.
  Library: Use wrapi.lib.