OID_WDI_SET_SAE_AUTH_PARAMS (dot11wificxintf.h)

Important

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

OID_WDI_SET_SAE_AUTH_PARAMS is sent by WDI in response to an NDIS_STATUS_WDI_INDICATION_SAE_AUTH_PARAMS_NEEDED indication from the driver. It contains the parameters required to send the Simultaneous Authentication of Equals (SAE) Commit or Confirm request, or an error message indicating a failure to perform SAE with the BSSID.

For SAE authentication using Wi-Fi 7 MLO, Windows sets the AKM and cipher in WDI_TLV_SAE_COMMIT_PARAMS. These values are specified in the WDI_TLV_RSNA_AKM_SUITE and WDI_TLV_CIPHER_ALGORITHM TLVs. The driver uses these values later on in the association request.

This command is sent as a Direct OID request to the driver.

For more information about SAE authentication, see WiFiCx WPA3 SAE authentication.

Command parameters

TLV Type Multiple TLV instances allowed Optional Description
WDI_TLV_BSSID WDI_MAC_ADDRESS The BSSID of the peer.
WDI_TLV_SAE_REQUEST_TYPE WDI_SAE_REQUEST_TYPE The type of SAE request frame to send to the BSSID.
WDI_TLV_SAE_COMMIT_PARAMS WDI_SAE_COMMIT_PARAMS X The SAE Commit request parameters. Used to send both commit-request and commit-response frames.
WDI_TLV_SAE_CONFIRM_PARAMS WDI_SAE_CONFIRM_PARAMS X The SAE Confirm request parameters. Used to send both confirm-request and confirm-response frames.
WDI_TLV_SAE_STATUS WDI_SAE_STATUS X SAE authentication failure error status.

Requirements

Requirement Value
Minimum supported client Windows 11
Minimum supported server Windows Server 2022
Header dot11wificxintf.h