Compartir a través de

NDIS_STATUS_DOT11_LINK_QUALITY

  • Artículo

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.

 

A miniport driver makes the NDIS_STATUS_DOT11_LINK_QUALITY indication whenever 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:

    typedef struct DOT11_LINK_QUALITY_PARAMETERS {
         NDIS_OBJECT_HEADER Header;
         ULONG uLinkQualityListSize;
         ULONG uLinkQualityListOffset;
    } DOT11_LINK_QUALITY_PARAMETERS,   *PDOT11_LINK_QUALITY_PARAMETERS;

The DOT11_LINK_QUALITY_PARAMETERS structure contains the following members:

Header
The type, revision, and size of the DOT11_LINK_QUALITY_PARAMETERS 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_LINK_QUALITY_PARAMETERS_REVISION_1.

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

For more information about these members, see NDIS_OBJECT_HEADER.

uLinkQualityListSize
The number of entries in the link quality list.

uLinkQualityListOffset
The offset of the link quality list. Each entry in the list specifies an association to an AP or peer station whose link quality has changed.

This offset is relative to the start of the buffer that contains the DOT11_LINK_QUALITY_PARAMETERS structure.

Each entry in the link quality list is formatted as a DOT11_LINK_QUALITY_ENTRY structure:

typedef struct DOT11_LINK_QUALITY_ENTRY {         DOT11_MAC_ADDRESS PeerMacAddr;
 UCHAR
 ucLinkQuality; } DOT11_LINK_QUALITY_ENTRY, *PDOT11_LINK_QUALITY_ENTRY;

The DOT11_LINK_QUALITY_ENTRY structure contains the following members:

PeerMacAddr
The media access control (MAC) address of the AP or peer station with which the link quality has changed. This member is formatted as a DOT11_MAC_ADDRESS structure.

ucLinkQuality
The link quality of the association, specified by a value within the range from 0 through 100.

The miniport driver must follow these guidelines when making 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 whenever 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.

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

     

    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 making 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.

For more information about link quality and link quality indications, see Link Quality Operations.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systemss.

Header

 Windot11.h (include Ndis.h)