Partager via

NDIS_STATUS_DOT11_LINK_QUALITY (Compact 2013)

  • Article

3/26/2014

A miniport driver makes the NDIS_STATUS_DOT11_LINK_QUALITY indication when the link quality of the association with an access point (AP) or peer station changes.

The data type for this indication is the DOT11_LINK_QUALITY_PARAMETERS structure.

The miniport driver must follow these guidelines when it makes the NDIS_STATUS_DOT11_LINK_QUALITY indication:

  • After the 802.11 station successfully associates with an AP or peer station, the miniport driver must make an NDIS_STATUS_DOT11_LINK_QUALITY indication shortly after it makes the NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION indication. The miniport driver makes this NDIS_STATUS_DOT11_LINK_QUALITY indication after it has determined the initial link quality of the association.
  • The miniport driver makes the Native 802.11 NDIS_STATUS_DOT11_LINK_QUALITY indication when the 802.11 station determines that the link quality to an associated AP or peer station has changed significantly since the last NDIS_STATUS_DOT11_LINK_QUALITY indication.
    The determination for making this indication is specific to the implementation by the independent hardware vendor (IHV). However, the miniport driver should implement some threshold mechanism to avoid making frequent indications.
  • Following each NDIS_STATUS_DOT11_LINK_QUALITY indication, the miniport driver must save the current link quality for each associated AP or peer station specified within the link quality list.
  • If the 802.11 station is connected to an independent basic service set (IBSS) network, the miniport driver can include entries in the link quality list for every associated peer station whose link quality has changed significantly since the last NDIS_STATUS_DOT11_LINK_QUALITY indication.
    If the 802.11 station is connected to an infrastructure BSS network, the link quality list must only contain an entry for the AP with which the 802.11 station is associated.

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

  • StatusCode must be set to NDIS_STATUS_DOT11_LINK_QUALITY
  • StatusBuffer must be set to the address of a DOT11_LINK_QUALITY_PARAMETERS structure
  • StatusBufferSize must be set to sizeof(DOT11_LINK_QUALITY_PARAMETERS) plus the values of the uLinkQualityListSize and uLinkQualityListOffset members

See Also

Reference

Native 802.11 Extensible Station Status Indications
DOT11_LINK_QUALITY_PARAMETERS
NDIS_STATUS_DOT11_LINK_QUALITY
NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION
NdisMIndicateStatusEx
NDIS_STATUS_INDICATION
Native 802.11 Wireless LAN Status Indications