說明
以下函數(shù)負責關(guān)閉任何打開的 HFP 端口。此函數(shù)在成功執(zhí)行時返回零，而在出現(xiàn)任何錯誤時返回負值。
參數(shù)
使用此命令不需要參數(shù)。參數(shù)對 Close 的結(jié)果沒有影響。
可能的返回值
- (0) 客戶端成功關(guān)閉
- (-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 調(diào)用
HFRE_Close_Port(BluetoothStackID, CurrentClientPortID)
API 原型
int BTPSAPI HFRE_Close_Port(unsigned int BluetoothStackID, unsigned int HFREPortID)
API 說明
可以使用以下函數(shù)來關(guān)閉先前由以下任何機制打開的 HFRE 端口：
- 成功調(diào)用 HFRE_Open_Remote_Hands-free_Port() 函數(shù)。
- 成功調(diào)用 HFRE_Open_Remote_Audio_Gateway_Port() 函數(shù)。
- 使用 HFRE_Open_Hands-free_Server_Port() 或 HFRE_Open_Audio_Gateway_Server_Port() 函數(shù)打開服務器端口的傳入打開請求（免提或音頻網(wǎng)關(guān)）。
該函數(shù)將以下內(nèi)容作為輸入：打開的 HFRE 端口所在藍牙協(xié)議棧的 ID 以及要關(guān)閉的端口的 HFRE 端口 ID（上述 Open 函數(shù)之一的返回值）。如果成功，此函數(shù)返回零；如果出現(xiàn)錯誤，則返回負值。此函數(shù)不會從系統(tǒng)中取消注冊 HFRE 服務器端口，而是僅斷開當前在服務器端口上處于活動狀態(tài)的任何連接。HFRE_Close_Server_Port() 函數(shù)可用于取消注冊 HFRE 服務器端口。