说明

以下函数负责向远程免提装置发送启用或禁用带内振铃指示。此函数在成功执行时返回零，而在出现任何错误时返回负值。

参数

此命令只需要一个参数。该值必须指定为 0（表示禁用）或 1（表示启用）。

命令调用示例

• “SetRingIndication 1”表示启用带内振铃指示
• “SetRingIndication 0”表示禁用带内振铃指示

可能的返回值

• (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_Enable_Remote_InBand_Ring_Tone_Setting(BluetoothStackID, CurrentClientPortID, TempParam->Params[0].intParam? TRUE : FALSE)

API 原型

BTPSAPI_DECLARATION int BTPSAPI HFRE_Enable_Remote_InBand_Ring_Tone_Setting(unsigned int BluetoothStackID, unsigned int HFREPortID, Boolean_tEnableInBandRing)

API 说明

此函数负责启用或禁用本地设备的带内铃声功能。此函数只能由存在有效服务级别连接的音频网关执行。仅当本地音频网关支持带内铃声功能时，才能使用此函数启用这些功能。该函数将以下内容作为输入参数：HFRE 端口 ID 有效的蓝牙协议栈 ID 以及 HFRE 端口 ID。最后一个参数是一个布尔标志，指定此调用要启用还是禁用该功能。如果成功，此函数返回零；如果出现错误，则返回负的错误代码。