When set, the OID_802_11_DESIRED_RATES OID requests that the miniport driver set the underlying NIC's set of data transmission rates to the values specified in an array. This array specifies the rates that are desirable for operation within the current wireless network. Data rates are encoded as eight bytes. Each byte describes a single rate in units of 0.5 Mbps. If an invalid rate value is specified, the miniport driver returns NDIS_STATUS_INVALID_DATA.
When queried, this OID requests that the miniport driver return the NIC's set of data transmission rates.
If the miniport driver does not support this OID, it returns NDIS_STATUS_NOT_SUPPORTED.
The IEEE 802.11 network might transmit packets at rates other than the rates in the IEEE 802.11 BSSBasicRateSet. The NIC can receive data at rates other than the rates included in the BSSBasicRateSet. For rates that the NIC supports, see OID_802_11_SUPPORTED_RATES.
This OID uses the NDIS_802_11_RATES array, which is defined as follows:
typedef UCHAR NDIS_802_11_RATES;
This array contains a set of eight bytes. Each byte specifies a desired data rate in units of 0.5 Mbps. Unused entries at the end of the array, if any, must be set to zero.
If the device supports more than eight rates, the miniport driver returns the highest eight rates. In contrast, when the OID_802_11_BSSID_LISTOID is queried, the miniport driver can return all rates using the NDIS_802_11_RATES_EX array.