说明

以下函数负责向远程 HID 设备发送 GET_REPORT 事务。此函数在成功执行时返回零，而在出现任何错误时返回负值。

参数

此函数需要三个或四个参数。第一个是 size（0 = grSizeOfReport，1 = grUseBufferSize），第二个是 ReportType（0 = rtOther，1 = rtInput，2 = rtOutput，3 = rtFeature），第三个是 ReportId。如果 size 参数为 1，则需要指定第四个参数 Buffersize。

可能的返回值

• (0) HID_Get_Report_Request：成功运行
• (-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
• (-1005)BTHID_ERROR_INVALID_OPERATION

API 调用

HID_Get_Report_Request(BluetoothStackID, HIDID, (HID_Get_Report_Size_Type_t)TempParam->Params[0].intParam, (HID_Report_Type_Type_t)TempParam->Params[1].intParam, (Byte_t)(TempParam->Params[2].intParam), (Word_t)(TempParam->Params[3].intParam))

API 原型

HID_Get_Report_Request(unsigned int BluetoothStackID, unsigned int HIDID, HID_Get_Report_Size_Type_t Size, HID_Report_Type_Type_t ReportType, Byte_t ReportID,Word_t BufferSize)

API 说明

以下函数负责向远程设备发送 GET_REPORT 事务。该函数将以下内容作为输入：蓝牙协议栈的 ID（用于发送请求）和已建立连接的 HID ID。第三个参数是指示设备如何确定主机已分配的缓冲区大小的描述符。第四个参数是所请求的报告的类型。第五个参数是由设备的 SDP 记录确定的报告 ID。将此参数设置为零表示不使用此参数，并从事务有效载荷中排除相应字节。使用的第五个参数基于作为大小传递的参数。如果主机指示分配的缓冲区大小小于报告请求的缓冲区大小，则此参数将用作返回的报告的大小。否则，事务有效载荷中不包含相应的字节。如果成功，此函数返回零；如果出现错误，则返回负的错误代码。