说明

以下函数负责设置远程设备上的麦克风增益。此函数在成功执行时返回零，而在出现任何错误时返回负值。如果 HF 设备支持远程音频音量控制功能，则此函数有效。

参数

此命令只需要麦克风增益整数值作为参数。

命令调用示例

• "SetMicroPhoneGain 5"
• "SetMicroPhoneGain 6"

可能的返回值

• (0) 命令发送成功
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-4) FUNCTION_ERROR
• (-8) INVALID_STACK_ID_ERROR
• (-1000) BTHFRE_ERROR_INVALID_PARAMETER
• (-1001) BTHFRE_ERROR_NOT_INITIALIZED
• (-1002) BTHFRE_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-1003) BTHFRE_ERROR_LIBRARY_INITIALIZATION_ERROR
• (-1004) BTHFRE_ERROR_INSUFFICIENT_RESOURCES
• (-1005) BTHFRE_ERROR_INVALID_OPERATION
• (-1006) BTHFRE_ERROR_INVALID_CODEC_ID

API 调用

HFRE_Set_Remote_Microphone_Gain(BluetoothStackID, CurrentClientPortID, TempParam->Params->intParam)

API 原型

BTPSAPI_DECLARATION int BTPSAPI HFRE_Set_Remote_Microphone_Gain(unsigned int BluetoothStackID, unsigned int HFREPortID, unsigned int MicrophoneGain)

API 说明

此函数负责允许同步和设置远程设备麦克风增益。仅当存在有效服务级别连接时，才能执行此函数。由免提装置调用时，此函数用于向远程音频网关通知当前麦克风增益值。由音频网关调用时，此函数可为音频网关提供一种方法来控制远程免提装置的麦克风增益。该函数将以下内容作为输入参数：HFRE 端口 ID 有效的蓝牙协议栈 ID 以及 HFRE 端口 ID。最后一个参数是要发送到远程设备的麦克风增益。麦克风增益参数 *必须* 介于 HFRE_MICROPHONE_GAIN_MINIMUM 和 HFRE_MICROPHONE_GAIN_MAXIMUM 的值之间。如果成功，此函数返回零；如果出现错误，则返回负的错误代码。