Edit

Share via

OID_WDI_TASK_START_AP (dot11wificxintf.h)

  • Article

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_TASK_START_AP requests that the IHV component configures a port to start a Wi-Fi Direct Group Owner on the specified port.

Object Abort capable Default priority (host driver policy) Normal execution time (seconds)
Port Yes. The abort must be followed by a dot11 reset. 4 1

During initialization, the driver sets the GO on 5GHz band capability in WIFI_WIFIDIRECT_CAPABILITIES to indicate whether it can start the access point on the 5 GHz band.

If GO on 5 GHz band support is set, the adapter should start the AP on the Advertised Operating channel, and if that fails, it should try the list specified in the AP band channel list parameter. The operating system will provide a hint to the driver about whether this AP would provide internet connectivity by setting the DOT11_WFD_GROUP_CAPABILITY_CROSS_CONNECTION_SUPPORTED flag in WDI_TLV_P2P_GROUP_OWNER_CAPABILITY.

If MustUseSpecifiedChannel in WDI_TLV_START_AP_PARAMETERS is specified, the AP may return one of the following errors if it is unable to start the AP on the specified band/channel(s):

  • NDIS_STATUS_DOT11_AP_CHANNEL_CURRENTLY_NOT_AVAILABLE: Unable to start the AP on the specified channel(s) right now . Retry on the specified channel(s) later.

  • NDIS_STATUS_DOT11_AP_BAND_CURRENTLY_NOT_AVAILABLE: Unable to start the AP on the specified band(s) right now. Retry on the specified band(s) later.

  • NDIS_STATUS_DOT11_AP_CHANNEL_NOT_ALLOWED: Unable to start the AP on the specified channel(s) due to regulatory reasons.

  • NDIS_STATUS_DOT11_AP_BAND_NOT_ALLOWED: Unable to start the AP on the specified band(s) due to regulatory reasons.

Task parameters

TLV Multiple TLV instances allowed Optional Description
WDI_TLV_SSID The SSID to be used by the AP.
WDI_TLV_START_AP_PARAMETERS Additional parameters for this task.
WDI_TLV_AUTH_ALGO_LIST The list of authentication algorithms that the connection can use.
WDI_TLV_MULTICAST_CIPHER_ALGO_LIST The list of multicast cipher algorithms that the connection can use.
WDI_TLV_UNICAST_CIPHER_ALGO_LIST The list of multicast cipher algorithms that the connection can use.
WDI_TLV_P2P_CHANNEL_NUMBER X If specified, this defines the operating channel determined in group formation. This may only be specified when the operating mode is Wi-Fi Direct GO.
WDI_TLV_AP_BAND_CHANNEL X X Optional list of bands and channels to start the access point on. If MustUseSpecifiedChannels is set to 1, the AP can only be started from this list. If it is not set, this list is meant to be a recommendation of channels that the firmware can pick from, and it may pick another channel if it is not possible to start the AP on any of the specified channels.

Task completion indication

NDIS_STATUS_WDI_INDICATION_START_AP_COMPLETE

Requirements

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