## 概述

PC/2in1

声明主机侧访问输入设备的HID DDK接口。

**引用文件：** <hid/hid\_ddk\_api.h>

**库：** libhid.z.so

**系统能力：** SystemCapability.Driver.HID.Extension

**起始版本：** 11

**相关模块：** [HidDdk](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk)

## 汇总

PC/2in1

### 函数

PC/2in1

展开

| 名称 | 描述 |
| --- | --- |
| [int32\_t OH\_Hid\_CreateDevice(Hid\_Device \*hidDevice, Hid\_EventProperties \*hidEventProperties)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_createdevice) | 创建设备。 |
| [int32\_t OH\_Hid\_EmitEvent(int32\_t deviceId, const Hid\_EmitItem items[], uint16\_t length)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_emitevent) | 向指定设备发送事件列表。 |
| [int32\_t OH\_Hid\_DestroyDevice(int32\_t deviceId)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_destroydevice) | 销毁设备。 |
| [int32\_t OH\_Hid\_Init(void)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_init) | 初始化HID DDK。 |
| [int32\_t OH\_Hid\_Release(void)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_release) | 释放HID DDK。 |
| [int32\_t OH\_Hid\_Open(uint64\_t deviceId, uint8\_t interfaceIndex, Hid\_DeviceHandle \*\*dev)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_open) | 打开deviceId和interfaceIndex指定的设备。 |
| [int32\_t OH\_Hid\_Close(Hid\_DeviceHandle \*\*dev)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_close) | 关闭设备。 |
| [int32\_t OH\_Hid\_Write(Hid\_DeviceHandle \*dev, uint8\_t \*data, uint32\_t length, uint32\_t \*bytesWritten)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_write) | 向设备写入报告。 |
| [int32\_t OH\_Hid\_ReadTimeout(Hid\_DeviceHandle \*dev, uint8\_t \*data, uint32\_t bufSize, int timeout, uint32\_t \*bytesRead)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_readtimeout) | 在指定的超时时间内从设备读取报告。 |
| [int32\_t OH\_Hid\_Read(Hid\_DeviceHandle \*dev, uint8\_t \*data, uint32\_t bufSize, uint32\_t \*bytesRead)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_read) | 从设备读取报告，默认为阻塞模式（阻塞等待直到有数据可读取），可以调用[OH\_Hid\_SetNonBlocking](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_setnonblocking)改变模式。 |
| [int32\_t OH\_Hid\_SetNonBlocking(Hid\_DeviceHandle \*dev, int nonBlock)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_setnonblocking) | 设置设备读取模式为非阻塞。 |
| [int32\_t OH\_Hid\_GetRawInfo(Hid\_DeviceHandle \*dev, Hid\_RawDevInfo \*rawDevInfo)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_getrawinfo) | 获取设备原始信息。 |
| [int32\_t OH\_Hid\_GetRawName(Hid\_DeviceHandle \*dev, char \*data, uint32\_t bufSize)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_getrawname) | 获取设备原始名称。 |
| [int32\_t OH\_Hid\_GetPhysicalAddress(Hid\_DeviceHandle \*dev, char \*data, uint32\_t bufSize)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_getphysicaladdress) | 获取设备物理地址。 |
| [int32\_t OH\_Hid\_GetRawUniqueId(Hid\_DeviceHandle \*dev, uint8\_t \*data, uint32\_t bufSize)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_getrawuniqueid) | 获取设备原始唯一标识符。 |
| [int32\_t OH\_Hid\_SendReport(Hid\_DeviceHandle \*dev, Hid\_ReportType reportType, const uint8\_t \*data, uint32\_t length)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_sendreport) | 向设备发送报告。 |
| [int32\_t OH\_Hid\_GetReport(Hid\_DeviceHandle \*dev, Hid\_ReportType reportType, uint8\_t \*data, uint32\_t bufSize)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_getreport) | 获取设备报告。 |
| [int32\_t OH\_Hid\_GetReportDescriptor(Hid\_DeviceHandle \*dev, uint8\_t \*buf, uint32\_t bufSize, uint32\_t \*bytesRead)](/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_getreportdescriptor) | 获取设备报告描述符。 |

## 函数说明

PC/2in1

### OH\_Hid\_CreateDevice()

PC/2in1



```
1. int32_t OH_Hid_CreateDevice(Hid_Device *hidDevice, Hid_EventProperties *hidEventProperties)
```

**描述**

创建设备。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 11

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Hid\_Device](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-device) \*hidDevice | 创建设备需要的基本信息，包括设备名、厂商ID、产品ID等。 |
| [Hid\_EventProperties](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-eventproperties) \*hidEventProperties | 创建的设备关注的事件，包括事件类型、按键事件属性、绝对坐标事件属性、相对坐标事件属性等。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | deviceID (一个非负的数字) 调用接口成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INVALID\_OPERATION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 连接hid\_ddk服务失败。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 参数校验失败。可能的原因：1. 入参hidDevice为空指针;  2. 入参hidEventProperties为空指针; 3. properties的长度超过7; 4. hidEventTypes的长度超过5;  5. hidKeys的长度超过100; 6. hidAbs的长度超过26; 7.hidRelBits的长度超过13;  8. hidMiscellaneous的长度超过6。  [HID\_DDK\_FAILURE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 设备数量达到最大值200。 |

### OH\_Hid\_EmitEvent()

PC/2in1



```
1. int32_t OH_Hid_EmitEvent(int32_t deviceId, const Hid_EmitItem items[], uint16_t length)
```

**描述**

向指定设备发送事件列表。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 11

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| int32\_t deviceId | 设备ID。 |
| items | 发送的事件列表，事件包括类型（取值来源事件类型Hid\_EventType）、编码（取值来源同步事件编码Hid\_SynEvent、键值编码Hid\_KeyCode、按钮编码HidBtnCode、绝对坐标编码Hid\_AbsAxes、相对坐标编码Hid\_RelAxes、其它类型的输入事件编码Hid\_MscEvent）、值（根据实际设备输入决定）。 |
| uint16\_t length | 发送事件列表长度（一次发送事件个数）。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 调用接口成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INVALID\_OPERATION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 连接hid\_ddk服务失败或者调用方不是设备的创建者。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 参数校验失败。可能的原因: 1.设备ID小于0;  2.入参length长度超过7; 3.入参items为空指针。  [HID\_DDK\_NULL\_PTR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 对应设备的注入为空。 |

### OH\_Hid\_DestroyDevice()

PC/2in1



```
1. int32_t OH_Hid_DestroyDevice(int32_t deviceId)
```

**描述**

销毁设备。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 11

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| int32\_t deviceId | 设备ID。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 调用接口成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INVALID\_OPERATION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 连接hid\_ddk服务失败或者调用方不是设备的创建者。  [HID\_DDK\_NULL\_PTR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 对应设备不存在。 |

### OH\_Hid\_Init()

PC/2in1



```
1. int32_t OH_Hid_Init(void)
```

**描述**

初始化HID DDK。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 初始化DDK失败。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。 |

### OH\_Hid\_Release()

PC/2in1



```
1. int32_t OH_Hid_Release(void)
```

**描述**

释放HID DDK。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。 |

### OH\_Hid\_Open()

PC/2in1



```
1. int32_t OH_Hid_Open(uint64_t deviceId, uint8_t interfaceIndex, Hid_DeviceHandle **dev)
```

**描述**

打开deviceId和interfaceIndex指定的设备。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| uint64\_t deviceId | 操作设备的ID。 |
| uint8\_t interfaceIndex | 接口索引，对应HID设备的接口。 |
| [Hid\_DeviceHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-devicehandle) \*\*dev | 设备操作句柄。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。  [HID\_DDK\_MEMORY\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) dev内存申请失败。  [HID\_DDK\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) I/O操作失败。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) dev为空或\*dev为空。  [HID\_DDK\_DEVICE\_NOT\_FOUND](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 根据deviceId和interfaceIndex找不到设备。 |

### OH\_Hid\_Close()

PC/2in1



```
1. int32_t OH_Hid_Close(Hid_DeviceHandle **dev)
```

**描述**

关闭设备。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Hid\_DeviceHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-devicehandle) \*\*dev | 设备操作句柄。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。  [HID\_DDK\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) I/O操作失败。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) dev为空或\*dev为空。 |

### OH\_Hid\_Write()

PC/2in1



```
1. int32_t OH_Hid_Write(Hid_DeviceHandle *dev, uint8_t *data, uint32_t length, uint32_t *bytesWritten)
```

**描述**

向设备写入报告。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Hid\_DeviceHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-devicehandle) \*dev | 设备操作句柄。 |
| uint8\_t \*data | 待写入的数据。 |
| uint32\_t length | 写入数据的字节长度，最大不超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)，否则无法通过参数校验。 |
| uint32\_t \*bytesWritten | 实际写入的数据字节数。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 参数校验失败。可能原因：1. dev为空；  2. data为空；3. length为0；4. length超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)；  5. bytesWritten为空。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。  [HID\_DDK\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) I/O操作失败。 |

### OH\_Hid\_ReadTimeout()

PC/2in1



```
1. int32_t OH_Hid_ReadTimeout(Hid_DeviceHandle *dev, uint8_t *data, uint32_t bufSize, int timeout, uint32_t *bytesRead)
```

**描述**

在指定的超时时间内从设备读取报告。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Hid\_DeviceHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-devicehandle) \*dev | 设备操作句柄。 |
| uint8\_t \*data | 存放读取数据的缓冲区。 |
| uint32\_t bufSize | 存放读取数据的缓冲区大小，最大不超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)，否则无法通过参数校验。 |
| int timeout | 超时时间（毫秒）或-1表示阻塞等待。 |
| uint32\_t \*bytesRead | 读取的字节数。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 参数校验失败。可能原因：1. dev为空；  2. data为空；3. bufSize为0；4. bufSize超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)；  5. bytesRead为空。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。  [HID\_DDK\_MEMORY\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 内存数据拷贝失败。  [HID\_DDK\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) I/O操作失败。  [HID\_DDK\_TIMEOUT](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 读取超时。 |

### OH\_Hid\_Read()

PC/2in1



```
1. int32_t OH_Hid_Read(Hid_DeviceHandle *dev, uint8_t *data, uint32_t bufSize, uint32_t *bytesRead)
```

**描述**

从设备读取报告，默认为阻塞模式（阻塞等待直到有数据可读取），可以调用[OH\_Hid\_SetNonBlocking](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_setnonblocking)改变模式。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Hid\_DeviceHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-devicehandle) \*dev | 设备操作句柄。 |
| uint8\_t \*data | 存放读取数据的缓冲区。 |
| uint32\_t bufSize | 存放读取数据的缓冲区大小，最大不超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)，否则无法通过参数校验。 |
| uint32\_t \*bytesRead | 读取的字节数。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 参数校验失败。可能原因：1. dev为空；  2. data为空；3. bufSize为0；4. bufSize超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)；  5.bytesRead为空。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。  [HID\_DDK\_MEMORY\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 内存数据拷贝失败。  [HID\_DDK\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) I/O操作失败。  [HID\_DDK\_TIMEOUT](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 读取超时。 |

### OH\_Hid\_SetNonBlocking()

PC/2in1



```
1. int32_t OH_Hid_SetNonBlocking(Hid_DeviceHandle *dev, int nonBlock)
```

**描述**

设置设备读取模式为非阻塞。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Hid\_DeviceHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-devicehandle) \*dev | 设备操作句柄。 |
| int nonBlock | 是否启用非阻塞模式读取数据。1: 启用非阻塞模式，调用[OH\_Hid\_Read](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-api-h#oh_hid_read)接口时，如果设备有可读的数据，读取并返回[HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode)，  如果设备没有数据可读，则返回[HID\_DDK\_TIMEOUT](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode)。0: 禁用非阻塞模式。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 参数校验失败。可能原因：1. dev为空；  2. nonBlock不是1或0。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。 |

### OH\_Hid\_GetRawInfo()

PC/2in1



```
1. int32_t OH_Hid_GetRawInfo(Hid_DeviceHandle *dev, Hid_RawDevInfo *rawDevInfo)
```

**描述**

获取设备原始信息。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Hid\_DeviceHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-devicehandle) \*dev | 设备操作句柄。 |
| [Hid\_RawDevInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-rawdevinfo) \*rawDevInfo | 设备原始信息，包含厂商ID、产品ID和总线类型。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 参数校验失败。可能原因：1. dev为空；  2. rawDevInfo为空。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。  [HID\_DDK\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) I/O操作失败。  [HID\_DDK\_INVALID\_OPERATION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 不支持此操作。 |

### OH\_Hid\_GetRawName()

PC/2in1



```
1. int32_t OH_Hid_GetRawName(Hid_DeviceHandle *dev, char *data, uint32_t bufSize)
```

**描述**

获取设备原始名称。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Hid\_DeviceHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-devicehandle) \*dev | 设备操作句柄。 |
| char \*data | 存放读取数据的缓冲区。 |
| uint32\_t bufSize | 存放读取数据的缓冲区大小，最大不超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)，否则无法通过参数校验。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 参数校验失败。可能原因：1. dev为空；  2. data为空；3. bufSize为0；4. bufSize超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。  [HID\_DDK\_MEMORY\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 内存数据拷贝失败。  [HID\_DDK\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) I/O操作失败。  [HID\_DDK\_INVALID\_OPERATION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 不支持此操作。 |

### OH\_Hid\_GetPhysicalAddress()

PC/2in1



```
1. int32_t OH_Hid_GetPhysicalAddress(Hid_DeviceHandle *dev, char *data, uint32_t bufSize)
```

**描述**

获取设备物理地址。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Hid\_DeviceHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-devicehandle) \*dev | 设备操作句柄。 |
| char \*data | 存放读取数据的缓冲区。 |
| uint32\_t bufSize | 存放读取数据的缓冲区大小，最大不超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)，否则无法通过参数校验。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 参数校验失败。可能原因：1. dev为空；  2. data为空；3. bufSize为0；4. bufSize超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。  [HID\_DDK\_MEMORY\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 内存数据拷贝失败。  [HID\_DDK\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) I/O操作失败。  [HID\_DDK\_INVALID\_OPERATION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 不支持此操作。 |

### OH\_Hid\_GetRawUniqueId()

PC/2in1



```
1. int32_t OH_Hid_GetRawUniqueId(Hid_DeviceHandle *dev, uint8_t *data, uint32_t bufSize)
```

**描述**

获取设备原始唯一标识符。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Hid\_DeviceHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-devicehandle) \*dev | 设备操作句柄。 |
| uint8\_t \*data | 存放读取数据的缓冲区。 |
| uint32\_t bufSize | 存放读取数据的缓冲区大小，最大不超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)，否则无法通过参数校验。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 参数校验失败。可能原因：1. dev为空；  2. data为空；3. bufSize为0；4. bufSize超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。  [HID\_DDK\_MEMORY\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 内存数据拷贝失败。  [HID\_DDK\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) I/O操作失败。  [HID\_DDK\_INVALID\_OPERATION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 不支持此操作。 |

### OH\_Hid\_SendReport()

PC/2in1



```
1. int32_t OH_Hid_SendReport(Hid_DeviceHandle *dev, Hid_ReportType reportType, const uint8_t *data, uint32_t length)
```

**描述**

向设备发送报告。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Hid\_DeviceHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-devicehandle) \*dev | 设备操作句柄。 |
| [Hid\_ReportType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_reporttype) reportType | 报告类型。 |
| const uint8\_t \*data | 待发送的数据。 |
| uint32\_t length | 发送数据的字节长度，最大不超过 [HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)，否则无法通过参数校验。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 参数校验失败。可能原因：1. dev为空；  2. data为空；3. length为0；4. length超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。  [HID\_DDK\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) I/O操作失败。  [HID\_DDK\_INVALID\_OPERATION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 不支持此操作。 |

### OH\_Hid\_GetReport()

PC/2in1



```
1. int32_t OH_Hid_GetReport(Hid_DeviceHandle *dev, Hid_ReportType reportType, uint8_t *data, uint32_t bufSize)
```

**描述**

获取设备报告。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Hid\_DeviceHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-devicehandle) \*dev | 设备操作句柄。 |
| [Hid\_ReportType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_reporttype) reportType | 报告类型。 |
| uint8\_t \*data | 存放读取数据的缓冲区。 |
| uint32\_t bufSize | 存放读取数据的缓冲区大小，最大不超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)，否则无法通过参数校验。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 参数校验失败。可能原因：1. dev为空；  2. data为空；3. bufSize为0；4. bufSize超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。  [HID\_DDK\_MEMORY\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 内存数据拷贝失败。  [HID\_DDK\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) I/O操作失败。  [HID\_DDK\_INVALID\_OPERATION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 不支持此操作。 |

### OH\_Hid\_GetReportDescriptor()

PC/2in1



```
1. int32_t OH_Hid_GetReportDescriptor(Hid_DeviceHandle *dev, uint8_t *buf, uint32_t bufSize, uint32_t *bytesRead)
```

**描述**

获取设备报告描述符。

**需要权限：** ohos.permission.ACCESS\_DDK\_HID

**起始版本：** 18

**参数：**

展开

| 参数项 | 描述 |
| --- | --- |
| [Hid\_DeviceHandle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hidddk-hid-devicehandle) \*dev | 设备操作句柄。 |
| uint8\_t \*buf | 存放描述符的缓冲区。 |
| uint32\_t bufSize | 缓冲区的字节大小，最大不超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)，否则无法通过参数校验。 |
| uint32\_t \*bytesRead | 读取的字节数。 |

**返回：**

展开

| 类型 | 说明 |
| --- | --- |
| int32\_t | [HID\_DDK\_SUCCESS](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 操作成功。  [HID\_DDK\_NO\_PERM](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 权限校验失败。  [HID\_DDK\_INVALID\_PARAMETER](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 参数校验失败。可能原因：1. dev为空；  2. buf为空；3. bufSize为0；4. bufSize超过[HID\_MAX\_REPORT\_BUFFER\_SIZE](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_max_report_buffer_size)；  5. bytesRead为空。  [HID\_DDK\_INIT\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) DDK未初始化。  [HID\_DDK\_SERVICE\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 与DDK服务通信失败。  [HID\_DDK\_MEMORY\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 内存数据拷贝失败。  [HID\_DDK\_IO\_ERROR](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) I/O操作失败。  [HID\_DDK\_INVALID\_OPERATION](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-hid-ddk-types-h#hid_ddkerrcode) 不支持此操作。 |