Edit

Share via


NDIS_STATUS_WDI_INDICATION_NLO_DISCOVERY

Important

This topic is part of the WDI driver model released in Windows 10. The WDI driver model is in maintenance mode and will only receive high priority fixes. WiFiCx is the Wi-Fi driver model released in Windows 11. We recommend that you use WiFiCx to take advantage of the latest features.

Miniport drivers use NDIS_STATUS_WDI_INDICATION_NLO_DISCOVERY to indicate Network List Offload (NLO) discovery.

Object
Port

The firmware detects APs for SSIDs pushed down in NLO. NLO is used in non-AOAC systems for fast connection when resuming from system sleep. It is also used in AOAC systems to scan APs for SSIDs that are pushed to the firmware.

The OS does not request periodic background scans when in CS. NLO scan is the preferred method in CS because the screen is off when users don’t need to see all visible APs but those for SSIDs that users have auto-connect profiles to auto connect to. The list of SSIDs to offload from the OS has a preferred authentication and cipher pair and up to 4 channel hints. When the list has at least one SSID, the firmware should start an NLO scan autonomously following the schedule of fast scan and slow scan phases. The class driver translates the OS request to a firmware request. The firmware is expected to do NLO scan according the schedule for the APs that support the preferred authentication and cipher pair associated with the SSIDs.

In each scan period, the firmware scans for SSIDs that match the criteria on the list of channels but not necessary constrained on the list of channels. The discovered AP information should be cached for indication.

When any matches are found, the firmware indicates NLO discovery and caches the list of discovered AP information for the host to retrieve.

The indication of NLO discovery happens in the following two cases.

  • When the NIC is in Dx:
    1. Trigger the wake interrupt and wait for set power to D0 to continue the following steps.
    2. Indicate NLO discovery.
    3. Indicate that the firmware woke the stack with the reason of NLO discovery.
  • When the NIC is in D0:
    • Indicate NLO discovery.

Payload data

Type Multiple TLV instances allowed Optional Description
WDI_TLV_BSS_ENTRY X A list of BSSIDs. The list must at least contain the entry that triggered this discovery status.

Requirements

Minimum supported client

Windows 10

Minimum supported server

Windows Server 2016

Header

Dot11wdi.h