DOT11_IBSS_PARAMS (Compact 2013)

3/26/2014

This structure is used when the miniport driver is requested to set parameters for use when it connects to an independent basic service set (IBSS) network.

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

DOT11_IBSS_PARAMS_REVISION_1

Size

This member must be set to sizeof(DOT11_IBSS_PARAMS)

bJoinOnly

Specifies whether the 802.11 station should join an existing IBSS network only, or can 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 can 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.

Gg158816.note(en-us,WinEmbedded.80).gifNote:
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 the bJoinOnly member of DOT11_IBSS_PARAMS 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 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 a 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.

DOT11_IBSS_PARAMS Member

Default Value

bJoinOnly

FALSE

uIEsOffset

0

uIEsLength

0

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. The miniport driver must unconditionally set the PMKID cache to its default value whenever OID_DOT11_RESET_REQUEST is set.

Header

windot11.h

Show: