說明

以下函數負責設置遠程設備上的麥克風增益。此函數在成功執行時返回零，而在出現任何錯誤時返回負值。如果 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 的值之間。如果成功，此函數返回零；如果出現錯誤，則返回負的錯誤代碼。