Configuration through a Network Profile

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.

 

This topic describes the manner in which a miniport driver, operating in Extensible Station (ExtSTA) mode, is configured through a network profile.

A network profile consists of the following configuration settings:

Connectivity Settings
These settings are required and are used to configure the 802.11 station for a network connection. Connectivity settings include:

  • Standard 802.11 connectivity settings, such as desired basic service set (BSS) type and the service set identifier (SSID) of the BSS with which the 802.11 station will connect. The operating system will configure the miniport driver with the standard connectivity settings through set requests of the Native 802.11 object identifiers (OIDs) described in Native 802.11 Miniport Driver Configuration.

  • Independent hardware vendor (IHV) connectivity settings. These settings are proprietary to the implementation by the IHV's miniport driver and 802.11 station. The IHV must install an IHV Extensions DLL in order to issue set requests to the miniport driver for the configuration of IHV connectivity settings. For more information about the IHV Extensions DLL, see Native 802.11 Software Architecture.

Security Settings
These settings are optional and are used to configure the 802.11 station for the security settings used on the network connection. Security settings include enabling 802.11 cipher and authentication algorithms, as well as defining decryption exemptions on certain packet types.

Security settings include:

When a network profile is selected for an 802.11 network connection, the operating system will first configure the miniport driver with the profile's connectivity settings in the following way:

The following figure illustrates the method used to configure connectivity settings on a miniport driver operating in ExtSTA mode.

diagram illustrating the method used to configure connectivity settings on a miniport driver operating in extsta mode

After the connectivity settings have been configured, the operating system will next configure the miniport driver with the profile's security settings in the following way:

  • If the network profile contains standard security, the operating system will issue OID set requests to the miniport driver to configure the 802.11 cipher and authentication algorithms specified in the profile. For more information about the OIDs used to configure standard 802.11 cipher and authentication algorithms, see Extensible Station Cipher Operations and Extensible Station Authentication Operations.

  • If network profile contains proprietary security settings supported by the IHV, the operating system will call the IHV Extension DLL's Dot11ExtIhvPerformPreAssociate function. The IHV Extensions DLL will parse the IHV security settings within the profile and will configure the miniport driver by calling the Dot11ExtNicSpecificExtension IHV Extensibility function, which causes the operating system to issue a method request of OID_DOT11_NIC_SPECIFIC_EXTENSION to the miniport driver with data from the function call. The IHV Extension DLL can make as many calls to Dot11ExtNicSpecificExtension as needed when parsing the IHV security settings..

    The IHV service can also register packet types for privacy exemptions through a call to the Dot11ExtSetEtherTypeHandling IHV Extensibility function, which causes the operating system to issue a set request of OID_DOT11_PRIVACY_EXEMPTION_LIST to the miniport driver with data from the function call. For more information about privacy exemption lists, see Decryption Exemptions.

After the connectivity and security settings have been configured on the miniport driver, the operating system will initiate a connection operation on the 802.11 station. For more information about this operation, see Connection Operations.

For more information about the IHV Extensions DLL, see Native 802.11 Software Architecture.