说明

以下函数负责打开音频网关客户端端口。此函数在成功执行时返回零，而在出现任何错误时返回负值。

参数

此命令需要两个参数。第一个参数是查询索引，第二个参数是远程设备端口号。

命令调用示例

• “OpenAudioGatewayClient 1 1”尝试根据查询索引 1 和远程端口号 1 打开音频网关客户端端口。
• “OpenAudioGatewayClient 2 3”尝试根据查询索引 2 和远程端口号 3 打开音频网关客户端端口。

可能的返回值

• (0) 成功打开 AG 客户端
• (-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_Open_Remote_Hands-free_Port(BluetoothStackID, InquiryResultList[(TempParam->Params[0].intParam-1)], TempParam->Params[1].intParam, Hands-free Profile Commands, ServiceDiscovery, OpenAudioGatewayClient, DEFAULT_AG_SUPPORTED_FEATURES, DEFAULT_CALL_HOLDING_SUPPORT, 0, NULL, HFRE_Event_Callback, (unsigned long)0)

API 原型

BTPSAPI_DECLARATION int BTPSAPI HFRE_Open_Remote_Hands-free_Port(unsigned int BluetoothStackID, BD_ADDR_t BD_ADDR, unsigned int RemoteServerPort, unsignedlong SupportedFeaturesMask, unsigned long CallHoldSupportMask, unsigned int NumberAdditionalIndicators, HFRE_Control_Indicator_Entry_t AdditionalSupportedIndicators[],HFRE_Event_Callback_t EventCallback, unsigned long CallbackParameter)

API 说明

以下函数负责在指定的远程设备上打开一个远程免提端口。此函数将蓝牙协议栈的蓝牙协议栈 ID（用于打开 HFRE 连接）作为第一个参数。第二个参数指定要连接的远程蓝牙设备的板地址（非 NULL）。第三个参数指定本地音频网关支持的功能。下一个参数是位掩码，指定支持的呼叫保持和多方处理功能。此函数的第五个参数是出现在前一个参数表示的列表中的指示器名称的数量。下一个参数是此音频网关支持的其他指示器的列表。如果“其他指示器”参数为 NULL 且“其他指示器的数量”为零，则不支持其他参数。最后两个参数分别指定 HFRE 事件回调函数和 HFRE 事件回调的回调参数，此回调用于处理与指定远程端口（正在打开状态、关闭状态等）的任何进一步交互。如果成功，此函数将返回非零正值；如果不成功，则返回负的错误代码。如果该函数成功，则返回值表示 HFRE 端口 ID，可将该 ID 传递给所有需要它的其他函数。一旦打开远程免提装置，只能通过调用 HFRE_Close_Port() 函数来关闭该装置（传递此函数的返回值）。