說明

以下函數負責向遠程免提裝置發送呼叫線路識別通知。此函數在成功執行時返回零，而在出現任何錯誤時返回負值。

參數

此命令僅需要一個參數，即呼叫者 ID（電話號碼）。

命令調用示例

"SendCallerIdNotification +9198787899889"

可能的返回值

• (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_Send_Call_Line_Identification_Notification(BluetoothStackID, CurrentClientPortID, TempParam->Params->strParam)

API 原型

BTPSAPI_DECLARATION int BTPSAPI HFRE_Send_Call_Line_Identification_Notification(unsigned int BluetoothStackID, unsigned int HFREPortID, char *PhoneNumber)

API 說明

此函數負責向遠程設備發送呼叫線路識別通知。此函數只能由已啟用呼叫線路識別通知且具有有效服務級別連接的音頻網關執行。該函數將以下內容作為輸入參數：HFRE 端口 ID 有效的藍牙協議棧 ID 以及 HFRE 端口 ID。最后一個參數是作為此響應中的參數之一所需的電話號碼。此參數應為指向以 NULL 為終止符的字符串的指針，且其長度 *必須* 介于 HFRE_PHONE_NUMBER_LENGTH_MINIMUM 和 HFRE_PHONE_NUMBER_LENGTH_MAXIMUM 的值之間。如果成功，此函數返回零；如果出現錯誤，則返回負的錯誤代碼。