說明

以下函數負責向遠程免提裝置發送啟用或禁用帶內振鈴指示。此函數在成功執行時返回零，而在出現任何錯誤時返回負值。

參數

此命令只需要一個參數。該值必須指定為 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。最后一個參數是一個布爾標志，指定此調用要啟用還是禁用該功能。如果成功，此函數返回零；如果出現錯誤，則返回負的錯誤代碼。