说明

以下函数负责连接到远程 HID 设备。此函数在成功执行时返回零，而在出现任何错误时返回负值。

参数

此命令需要查询索引号，查询完成后可以使用 DisplayInquiryList 命令找到该编号。

可能的返回值

• (0)HID_Connect_Remote_Device：成功运行
• (-4) FUNCTION_ERROR
• (-6)INVALID_PARAMETERS_ERROR
• (-8) INVALID_STACK_ID_ERROR
• (-103)BTPS_ERROR_FEATURE_NOT_AVAILABLE
• (-1000)BTHID_ERROR_INVALID_PARAMETER
• (-1001)BTHID_ERROR_NOT_INITIALIZED
• (-1002)BTHID_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-1004)BTHID_ERROR_INSUFFICIENT_RESOURCES

API 调用

HID_Connect_Remote_Device(BluetoothStackID, InquiryResultList[(TempParam->Params->intParam-1)], &HIDConfiguration, HID_Event_Callback, 0)

API 原型

int BTPSAPI HID_Connect_Remote_Device(unsigned int BluetoothStackID, BD_ADDR_t BD_ADDR, HID_Configuration_t *HIDConfiguration, HID_Event_Callback_tEventCallback, unsigned long CallbackParameter)

API 说明

以下函数负责在指定的蓝牙设备上打开与远程 HID 设备的连接。此函数使用蓝牙协议栈的 ID（用于打开 HID 连接）作为第一个参数。第二个参数指定要连接的远程蓝牙设备的板地址（非 NULL）。此函数的第三个参数是 HID 配置规范，将用于协商与此设备客户端关联的 L2CAP 通道。最后两个参数分别指定 HID 事件回调的 HID 事件回调函数和回调参数，HID 事件回调用于处理与此设备客户端关联的任何其他事件。如果成功，此函数将返回非零正值；如果不成功，则返回负的错误代码。如果该函数成功，则返回值代表 HID ID，可将该 ID 传递给所有需要它的其他函数。一旦打开与远程设备的连接，只能通过调用 HID_Close_Connection() 函数来关闭连接（将成功调用此函数后的返回值作为 HID ID 输入参数传入）。