OID_DOT11_WFD_CONNECT_TO_GROUP_REQUEST

  • 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_WFD_CONNECT_TO_GROUP_REQUEST object identifier (OID) requests that the miniport driver perform a connection operation to join a Wi-Fi Direct (WFD) group. The operation for this OID is identical to that of an OID_DOT11_CONNECT_REQUEST request for an Extensible Station (ExtSTA) port. For more information about the connection operation, see Connection Operations.

No data is associated with this OID.

If the connection operation completes successfully, the miniport driver must transition to the WFD client operational (OP) state. The miniport driver must remain in the WFD client OP state until either a method request of OID_DOT11_RESET_REQUEST or set request of OID_DOT11_WFD_DISCONNECT_FROM_GROUP_REQUEST is made. For more information about this state, see Extensible Station Operating States.

When OID_DOT11_WFD_CONNECT_TO_GROUP_REQUEST is set, the miniport driver must fail the request by returning NDIS_STATUS_POWER_STATE_INVALID from its MiniportOidRequest function if any of the following are true:

  • All of the PHYs specified through the ExtSTA msDot11DesiredPhyList MIB object are turned off through sets of OID_DOT11_NIC_POWER_STATE. For more information about this MIB object, see OID_DOT11_DESIRED_PHY_LIST.

  • All of the PHYs specified through the ExtSTA msDot11DesiredPhyList MIB object are turned off through a hardware switch setting or proprietary software setting.

  • Additional criteria apply for the connection request to fail, as described in General Connection Operation Guidelines.

When OID_DOT11_WFD_CONNECT_TO_GROUP_REQUEST is set, the miniport driver can do one of the following:

  • Wait for the connection operation to complete before completing the set request.

  • Initiate the connection operation and complete the set request. In this situation, the miniport driver must return NDIS_STATUS_PENDING from its MiniportOidRequest function after initiating the connection operation. After the reset operation has finished, the miniport driver completes the set request by calling NdisMRequestComplete.

Requirements

Version

Versions: Supported in Windows 8.

Header

 Windot11.h (include Windot11.h)

See also

OID_DOT11_CONNECT_REQUEST

OID_DOT11_RESET_REQUEST

OID_DOT11_WFD_DISCONNECT_FROM_GROUP_REQUEST