Share via

NDIS_STATUS_DOT11_ASSOCIATION_START (Compact 2013)

  • [アーティクル]

3/26/2014

A miniport driver must make a NDIS_STATUS_DOT11_ASSOCIATION_START indication before it starts an association operation with either an access point (AP) (for infrastructure BSS networks) or peer station (for independent BSS (IBSS) networks).

The miniport driver indicates the completion of the association operation through the NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication. Every NDIS_STATUS_DOT11_ASSOCIATION_START indication made by the driver must have a corresponding NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication.

The data type for this indication is the DOT11_ASSOCIATION_START_PARAMETERS structure:

The 802.11 station starts an association operation when:

  • The 802.11 station is performing a connection operation. The miniport driver indicates the start of a connection operation by the NDIS_STATUS_DOT11_CONNECTION_START indication.
  • The 802.11 station is performing a roaming operation. The miniport driver indicates the start of a roaming operation by the NDIS_STATUS_DOT11_ROAMING_START indication.
  • A peer station in an IBSS network starts an association with the 802.11 station. The IEEE 802.11 dot11DesiredBSSType MIB object must be set to dot11_BSS_type_independent, and the 802.11 station must have joined the IBSS network in a previous connection or roaming operation.
    The 802.11 station can start this kind of association operation outside the scope of a connection or roaming operation.
    For more information about the dot11DesiredBSSType MIB object, see OID_DOT11_DESIRED_BSS_TYPE.

The miniport driver calls NdisMIndicateStatusEx to make an NDIS_STATUS_DOT11_ASSOCIATION_START indication, and must pass a pointer to an NDIS_STATUS_INDICATION structure through the StatusIndication parameter. When it makes this indication, the driver must set the following members of the NDIS_STATUS_INDICATION structure:

  • StatusCode must be set to NDIS_STATUS_DOT11_ASSOCIATION_START
  • StatusBuffer must be set to the address of a DOT11_ASSOCIATION_START_PARAMETERS structure
  • StatusBufferSize must be set to sizeof(DOT11_ASSOCIATION_START_PARAMETERS)

Note

Before it starts an association operation, the miniport driver must allocate all resources that it will need to make the corresponding NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication.

See Also

Reference

Native 802.11 Extensible Station Status Indications
NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION
DOT11_ASSOCIATION_START_PARAMETERS
NDIS_STATUS_DOT11_CONNECTION_START
NDIS_STATUS_DOT11_ROAMING_START
OID_DOT11_DESIRED_BSS_TYPE
NDIS_STATUS_INDICATION
NDIS_STATUS_DOT11_ASSOCIATION_START
Native 802.11 Wireless LAN Status Indications