OID_DOT11_IBSS_PARAMS

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_IBSS_PARAMS object identifier (OID) requests that the miniport driver set parameters to be used when connecting to an independent basic service set (IBSS) network.

Note  IBSS (Ad hoc) and SoftAP are deprecated. Starting with Windows 8.1 and Windows Server 2012 R2, use Wi-Fi Direct.

When queried, this OID requests that the miniport driver return the IBSS network connection parameters.

If the IEEE dot11DesiredBSSType management information base (MIB) object is set to dot11_BSS_type_independent, the 802.11 station uses the IBSS network parameters when performing a connection operation to an IBSS network. Connection operations are initiated through a set of OID_DOT11_CONNECT_REQUEST.

For more information about the dot11DesiredBSSType MIB object, see OID_DOT11_DESIRED_BSS_TYPE.

The data type for OID_DOT11_IBSS_PARAMS is the DOT11_IBSS_PARAMS structure.

    typedef struct DOT11_IBSS_PARAMS {
         NDIS_OBJECT_HEADER Header;
         BOOLEAN bJoinOnly;
         ULONG uIEsOffset;
         ULONG uIEsLength;
    } DOT11_IBSS_PARAMS, *PDOT11_IBSS_PARAMS;
  

This structure includes the following members:

Header
The type, revision, and size of the DOT11_IBSS_PARAMS structure. This member is formatted as an NDIS_OBJECT_HEADER structure.

The miniport driver must set the members of Header to the following values:

Type
This member must be set to NDIS_OBJECT_TYPE_DEFAULT.

Revision
This member must be set to DOT11_IBSS_PARAMS_REVISION_1.

Size
This member must be set to sizeof(DOT11_IBSS_PARAMS).

For more information about these members, see NDIS_OBJECT_HEADER.

bJoinOnly
Specifies whether the 802.11 station should only join an existing IBSS network or start a new IBSS network during the connection operation.

If bJoinOnly is FALSE, the 802.11 station must join an existing IBSS network if the station detects one. If the 802.11 station does not detect an IBSS network, the station must start a new one.

If bJoinOnly is TRUE, the 802.11 station must only join an existing IBSS network. If the 802.11 station does not detect an IBSS network, the station must continue searching for an IBSS network to join until either a set request of OID_DOT11_DISCONNECT_REQUEST or a set request of OID_DOT11_RESET_REQUEST is made.

uIEsOffset
Offset in the InformationBuffer member of the NDIS_OID_REQUEST structure where additional 802.11 Information Elements (IE) are stored.

The 802.11 station must append these additional IEs to the end of every transmitted 802.11 Beacon or Probe Response frames. If adding the additional IEs causes the size of the frames to exceed the maximum length for 802.11 media access control (MAC) management protocol data unit (MMPDU) frames, the 802.11 station must not append the additional IEs.

Note  If it cannot append the additional IEs, the 802.11 station must remain connected to the IBSS network.

uIEsOffset is calculated from the beginning of the DOT11_IBSS_PARAMS structure.

uIEsLength
Length of the additional 802.11 IEs. If uIEsLength is zero, no additional IEs are stored.

The 802.11 station must follow these guidelines when bJoinOnly is set to TRUE.

• After joining an existing IBSS network, the 802.11 station cannot perform a roaming operation to a new IBSS network until it is the only station within the IBSS network with which it is joined. If it is the only station within the IBSS network with which it is joined, it should stop sending Beacon frames and must continue searching for an IBSS network to join until either a set request of OID_DOT11_DISCONNECT_REQUEST or a method request of OID_DOT11_RESET_REQUEST is made.

• If the 802.11 station supports 802.11h for IBSS networks, the station must not enter the DFS owner recovery mode as defined in Clause 11.6.7.2 of the IEEE 802.11h-2003 standard. Instead, the 802.11 station must disassociate from all the existing peer stations within the IBSS network and perform a roaming operation to another IBSS network.

  If the 802.11 station does not detect another IBSS network, the station must continue searching for an IBSS network to join until either a set request of OID_DOT11_DISCONNECT_REQUEST or a method request of OID_DOT11_RESET_REQUEST is made.

The default values for the members of the DOT11_IBSS_PARAMS structure are defined in the following table.

The miniport driver must set the members of the DOT11_IBSS_PARAMS structure to the default values if any of the following occurs:

• The miniport driver's MiniportInitializeEx function is called.

• A method request of OID_DOT11_RESET_REQUEST is made.

Requirements

See also

Native 802.11 Wireless LAN OIDs