Edit

DOT11_OFFLOAD_NETWORK_LIST_INFO structure (windot11.h)

  • Article
Important  The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.
 
The DOT11_OFFLOAD_NETWORK_LIST_INFO structure describes a network offload-list (NLO).

Syntax

typedef struct _DOT11_OFFLOAD_NETWORK_LIST_INFO {
  NDIS_OBJECT_HEADER    Header;
  ULONG                 ulFlags;
  ULONG                 FastScanPeriod;
  ULONG                 FastScanIterations;
  ULONG                 SlowScanPeriod;
  ULONG                 uNumOfEntries;
  DOT11_OFFLOAD_NETWORK offloadNetworkList[1];
} DOT11_OFFLOAD_NETWORK_LIST_INFO, *PDOT11_OFFLOAD_NETWORK_LIST_INFO;

Members

Header

The type, revision, and size of the DOT11_OFFLOAD_NETWORK_LIST_INFO structure. The required settings for the members of Header are the following.

Member Setting
Type NDIS_OBJECT_TYPE_DEFAULT
Revision DOT11_OFFLOAD_NETWORK_LIST_REVISION_1
Size DOT11_SIZEOF_OFFLOAD_NETWORK_LIST_INFO_REVISION_1

ulFlags

Bit flags to specify extra attributes of this NLO from the following table:

Value Meaning
DOT11_NLO_FLAG_STOP_NLO_INDICATION Specifies that NLO scan should be stopped right away. No more NLO scans should occur. Nor should NLO discovery be indicated. uNumOfEntries should be 0.
DOT11_NLO_FLAG_SCAN_ON_AOAC_PLATFORM Specifies that NLO should scan immediately, and the schedule of fast scan and slow scan should be followed. This is normally used on Always-On-Always-Connected (AOAC) platforms. uNumOfEntries can be from 0 to n.
DOT11_NLO_FLAG_SCAN_AT_SYSTEM_RESUME Specifies that NLO is meant to be used at system resume on non-AOAC platforms, which is never the case for AOAC platforms. The NLO OID may be sent beforehand, when the systems is being suspended. Miniport/hardware should not start NLO scan right away. The list should be kept in miniport driver or hardware. When the system resumes, the miniport/hardware should try to connect to the previous connected network. The list should be scan right after the effort failed or when there is no previous connected AP to reconnect to.

FastScanPeriod

Fast scan period, in seconds. When the NIC receives the offload list, it should scan for matches to the list within the FastScanPeriod interval. In the fast scan period, the NIC scans for interesting SSIDs every such period for FastScanIteration then it switches to SlowScanPeriod.

FastScanIterations

Number if iterations to repeat the fast scan. When the number of iterations is reached the NIC switches to the SlowScanPeriod.

SlowScanPeriod

Slow scan period, in seconds. After the FastScanPeriod expires, the NIC switch to the SlowScanPeriod. The NIC should scan for matches to the list within the SlowScanPeriod. The duration is open ended until Windows issues an updated offload-list.

uNumOfEntries

Number of networks in the list of those requested to offload.

offloadNetworkList[1]

Array of networks that hardware should automatically search for.

Requirements

Requirement Value
Minimum supported client Versions:_Supported in Windows 8
Header windot11.h (include Windot11.h)