When set, the OID_802_11_RSSI_TRIGGER OID requests that the miniport driver set an RSSI trigger value. This value determines when a media-specific RSSI indication can be made by the miniport driver. For more information about RSSI indications, see 802.11 Media-Specific Status Indications.
The normal range for the RSSI trigger values is from -10 through -200 dBm. The miniport driver returns NDIS_STATUS_INVALID_DATA if an invalid RSSI value is specified.
When queried, this OID requests that the miniport driver return the current RSSI trigger value. The driver must return NDIS_STATUS_ADAPTER_NOT_READY if an RSSI trigger has not been previously set.
The trigger value contains the RSSI measurement in units of dBm, and the data type is defined as follows:
typedef LONG NDIS_802_11_RSSI;
The miniport driver makes an RSSI indication whenever the RSSI crosses the trigger line (either from below or from above), as follows:
If the RSSI trigger value is less than the current RSSI value, the miniport driver makes the RSSI indication when the RSSI value changes and becomes greater than or equal to the trigger value.
If the trigger value is greater than the current value, the miniport driver makes the RSSI indication when the RSSI value changes and becomes less than or equal to the trigger value.
If the trigger value is equal to the current value, the miniport driver makes the RSSI indication immediately.