ZHCACZ4 August 2023 CC2564C
以下函数负责设置远程设备上的扬声器增益。此函数在成功执行时返回零,而在出现任何错误时返回负值。如果 HF 设备支持远程音频音量控制功能,则此函数有效。
此命令只需要扬声器增益整数值作为参数。
HFRE_Set_Remote_Speaker_Gain(BluetoothStackID, CurrentClientPortID, TempParam->Params->intParam)
BTPSAPI_DECLARATION int BTPSAPI HFRE_Set_Remote_Speaker_Gain(unsigned int BluetoothStackID, unsigned int HFREPortID, unsigned int SpeakerGain)
此函数负责允许同步和设置远程设备扬声器增益。仅当存在有效服务级别连接时,才能执行此函数。由免提装置调用时,此函数用于向远程音频网关通知当前扬声器增益值。由音频网关调用时,此函数可为音频网关提供一种方法来控制远程免提装置的扬声器增益。该函数将以下内容作为输入参数:HFRE 端口 ID 有效的蓝牙协议栈 ID 以及 HFRE 端口 ID。最后一个参数是要发送到远程设备的扬声器增益。扬声器增益参数 *必须* 介于 HFRE_SPEAKER_GAIN_MINIMUM 和 HFRE_SPEAKER_GAIN_MAXIMUM 的值之间。如果成功,此函数返回零;如果出现错误,则返回负的错误代码。