说明

以下函数负责关闭任何打开的 HFP 端口。此函数在成功执行时返回零，而在出现任何错误时返回负值。

参数

使用此命令不需要参数。参数对 Close 的结果没有影响。

可能的返回值

• (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_Close_Port(BluetoothStackID, CurrentClientPortID)

API 原型

int BTPSAPI HFRE_Close_Port(unsigned int BluetoothStackID, unsigned int HFREPortID)

API 说明

可以使用以下函数来关闭先前由以下任何机制打开的 HFRE 端口：

• 成功调用 HFRE_Open_Remote_Hands-free_Port() 函数。
• 成功调用 HFRE_Open_Remote_Audio_Gateway_Port() 函数。
• 使用 HFRE_Open_Hands-free_Server_Port() 或 HFRE_Open_Audio_Gateway_Server_Port() 函数打开服务器端口的传入打开请求（免提或音频网关）。

该函数将以下内容作为输入：打开的 HFRE 端口所在蓝牙协议栈的 ID 以及要关闭的端口的 HFRE 端口 ID（上述 Open 函数之一的返回值）。如果成功，此函数返回零；如果出现错误，则返回负值。此函数不会从系统中取消注册 HFRE 服务器端口，而是仅断开当前在服务器端口上处于活动状态的任何连接。HFRE_Close_Server_Port() 函数可用于取消注册 HFRE 服务器端口。