diff --git a/wifi/aidl/android/hardware/wifi/IWifiStaIface.aidl b/wifi/aidl/android/hardware/wifi/IWifiStaIface.aidl index 2c81984d40..6d6afafc12 100644 --- a/wifi/aidl/android/hardware/wifi/IWifiStaIface.aidl +++ b/wifi/aidl/android/hardware/wifi/IWifiStaIface.aidl @@ -534,14 +534,18 @@ interface IWifiStaIface { void stopSendingKeepAlivePackets(in int cmdId); /** - * Set DTIM multiplier used when the system is in the suspended mode. + * Set maximum acceptable DTIM multiplier to hardware driver. + * Any multiplier larger than this maximum value must not be accepted since it will cause + * packet loss higher than what the system can accept, which will cause unexpected behavior + * for apps, and may interrupt the network connection. + * * When STA is in the power saving mode and system is suspended, * the wake up interval will be set to: * 1) multiplier * DTIM period if multiplier > 0. * 2) the driver default value if multiplier <= 0. * Some implementations may apply an additional cap to wake up interval in the case of 1). * - * @param multiplier integer DTIM multiplier value to set. + * @param multiplier integer maximum DTIM multiplier value to set. * @throws ServiceSpecificException with one of the following values: * |WifiStatusCode.ERROR_WIFI_IFACE_INVALID|, * |WifiStatusCode.ERROR_NOT_SUPPORTED|,