OID_DOT11_WPS_ENABLED

  • 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.

 

When set, the OID_DOT11_WPS_ENABLED object identifier (OID) requests that the miniport driver set the value of the Boolean msDot11WpsEnabled management information base (MIB) object. If msDot11WpsEnabled is set to TRUE, WiFi Protected Setup (WPS) is enabled on the NIC. Otherwise WPS is disabled. The NIC must complete the set request regardless of whether the Extensible AP is in the INIT or OP states.

When queried, this OID requests that the miniport driver return the value of the Boolean msDot11WpsEnabled MIB object. If msDot11AdditionalIEs is TRUE, WiFi Protected Setup (WPS) is enabled on the NIC. Otherwise WPS is disabled.

The msDot11WpsEnabled object is only applicable to the Extensible AP.

Note  Support for this OID is mandatory.

 

The default value of msDot11WpsEnabled is FALSE. It is reset to the default value whenever an OID_DOT11_RESET_REQUEST request is received.

If WPS is enabled on a NIC that is operating in Extensible AP mode, the miniport driver must allow peer stations to associate with the Extensible AP by using Open System Authentication or Wired Equivalent Privacy (WEP) algorithms, regardless of the enabled authorization and cipher algorithms. For these peer stations, the miniport driver must enforce the following:

  • For inbound packets, only unicast 802.1X packets are accepted. Other data packets will be dropped.

  • For outbound packets, only unicast 802.1X packets are allowed to be sent to the stations. Broadcast and multicast packets are not affected.

  • No encryption or decryption is allowed on unicast data packets. Inbound encrypted data packets are dropped.

When WPS is disabled, the miniport driver must disassociate all peer stations that were associated by using Open System Authentication or WEP algorithms if they were not among the enabled authorization and cipher algorithms.

The 802.11 miniport driver should allow only the following pairs of DOT11_AUTH_ALGORITHM and DOT11_CIPHER_ALGORITHM authentication and cipher algorithms, depending on whether WPS is enabled or disabled.

WPS is enabled

  • DOT11_AUTH_ALGO_WPA_PSK/DOT11_CIPHER_ALGO_CCMP

  • DOT11_AUTH_ALGO_80211_OPEN/DOT11_CIPHER_ALGO_WEPXXX

  • DOT11_AUTH_ALGO_80211_OPEN/DOT11_CIPHER_ALGO_NONE

WPS is disabled

  • DOT11_AUTH_ALGO_WPA_PSK/DOT11_CIPHER_ALGO_CCMP

Note  The NIC's response to 802.11 Beacon or Probe Response frames must not change when WPS is enabled with this OID, even if some peer stations were associated by using Open System Authentication or WEP algorithms.

 

Requirements

Version

Available in Windows 7 and later versions of the Windows operating systems.

Header

 Windot11.h (include Ndis.h)

See also

OID_DOT11_RESET_REQUEST

Native 802.11 Wireless LAN OIDs