OID_DOT11_DATA_RATE_MAPPING_TABLE

  • Article

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 queried, the OID_DOT11_DATA_RATE_MAPPING_TABLE object identifier (OID) requests that the miniport driver return the table of data rates supported by a PHY on the 802.11 station for transmit and receive operations.

The data type for OID_DOT11_DATA_RATE_MAPPING_TABLE is the DOT11_DATA_RATE_MAPPING_TABLE structure.

    typedef struct _DOT11_DATA_RATE_MAPPING_TABLE {
         NDIS_OBJECT_HEADER Header;
         ULONG uDataRateMappingLength;
         DOT11_DATA_RATE_MAPPING_ENTRY DataRateMappingEntries[126];
    } DOT11_DATA_RATE_MAPPING_TABLE, *PDOT11_DATA_RATE_MAPPING_TABLE;

This structure includes the following members:

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

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

For more information about these members, see NDIS_OBJECT_HEADER.

uDataRateMappingLength
The number of entries in the DataRateMappingEntries array.

DataRateMappingEntries
The data rates supported by the 802.11 station. Each entry in the DataRateMappingEntries array is formatted as a DOT11_DATA_RATE_MAPPING_ENTRY structure.

When OID_DOT11_DATA_RATE_MAPPING_TABLE is queried, the miniport driver must do the following:

  • Return the data rates for the current PHY type.

    The current PHY type is determined through the ExtSTA msDot11CurrentPhyID management information base (MIB) object. This MIB object specifies the index of the current PHY type within the 802.11 station's list of supported PHY types. For more information about this MIB object, see OID_DOT11_CURRENT_PHY_ID.

  • Return all of the IEEE 802.11 standard data rates, even if the PHY does not support the data rate.

  • Return any proprietary, non-standard data rates supported by the PHY.

Requirements

Version

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

Header

 Windot11.h (include Ndis.h)

See also

Native 802.11 Wireless LAN OIDs