---
title: IOHIDElement
framework: hiddriverkit
role: symbol
role_heading: Class
path: hiddriverkit/iohidelement
---

# IOHIDElement

An object that contains parsed information from a HID input report.

## Declaration

```occ
class IOHIDElement;
```

## Overview

Overview An IOHIDElement object contains details about a particular aspect of a HID-related input report. After receiving an input report from a HID device, IOUserHIDEventService and IOHIDInterface objects divide the report details into IOHIDElement objects for easier management. You use these element objects to obtain details about the report, such as the current value reported by the device, how that value is meant to be used, and the minimum and maximum values. For example, a report from a mouse usually contains separate elements for the mouse’s x and y positions. You don’t create IOHIDElement objects directly. Instead, use the getElements method of your IOUserHIDEventService or IOHIDInterface object to fetch the elements associated with the latest report. Each time you call that method, the corresponding object updates the element data using the most recent report.

## Topics

### Getting an Element’s Usage Information

- [getUsagePage](hiddriverkit/iohidelement/getusagepage.md)
- [getUsage](hiddriverkit/iohidelement/getusage.md)

### Accessing the Element’s Value

- [getValue](hiddriverkit/iohidelement/getvalue.md)
- [getDataValue](hiddriverkit/iohidelement/getdatavalue.md)
- [getScaledValue](hiddriverkit/iohidelement/getscaledvalue.md)
- [getScaledFixedValue](hiddriverkit/iohidelement/getscaledfixedvalue.md)
- [setValue](hiddriverkit/iohidelement/setvalue.md)
- [setDataValue](hiddriverkit/iohidelement/setdatavalue.md)
- [getUnit](hiddriverkit/iohidelement/getunit.md)
- [getUnitExponent](hiddriverkit/iohidelement/getunitexponent.md)
- [IOHIDValueOptions](hiddriverkit/iohidvalueoptions.md)
- [Value Options](hiddriverkit/value-options-enum.md)
- [IOHIDValueScaleType](hiddriverkit/iohidvaluescaletype.md)
- [Value Scale Types](hiddriverkit/value-scale-types-enum.md)

### Getting Minimum and Maximum Values

- [getLogicalMin](hiddriverkit/iohidelement/getlogicalmin.md)
- [getLogicalMax](hiddriverkit/iohidelement/getlogicalmax.md)
- [getPhysicalMin](hiddriverkit/iohidelement/getphysicalmin.md)
- [getPhysicalMax](hiddriverkit/iohidelement/getphysicalmax.md)

### Getting the Element’s Timestamp

- [getTimeStamp](hiddriverkit/iohidelement/gettimestamp.md)

### Managing the Element Hierarchy

- [getType](hiddriverkit/iohidelement/gettype.md)
- [getCollectionType](hiddriverkit/iohidelement/getcollectiontype.md)
- [getChildElements](hiddriverkit/iohidelement/getchildelements.md)
- [getParentElement](hiddriverkit/iohidelement/getparentelement.md)
- [IOHIDElementType](hiddriverkit/iohidelementtype.md)
- [IOHIDElementCollectionType](hiddriverkit/iohidelementcollectiontype.md)

### Getting Report Information

- [getReportID](hiddriverkit/iohidelement/getreportid.md)
- [getReportCount](hiddriverkit/iohidelement/getreportcount.md)
- [getReportSize](hiddriverkit/iohidelement/getreportsize.md)
- [IOHIDReportType](hiddriverkit/iohidreporttype.md)

### Identifying the Element

- [getCookie](hiddriverkit/iohidelement/getcookie.md)
- [IOHIDElementCookie](hiddriverkit/iohidelementcookie.md)

### Getting the Element Flags

- [getFlags](hiddriverkit/iohidelement/getflags.md)
- [IOHIDElementFlags](hiddriverkit/iohidelementflags.md)
- [HID Element Flags](hiddriverkit/hid-element-flags-enum.md)

### Committing Changes to Elements

- [commit](hiddriverkit/iohidelement/commit.md)
- [IOHIDElementCommitDirection](hiddriverkit/iohidelementcommitdirection.md)

### Instance Methods

- [conformsTo](hiddriverkit/iohidelement/conformsto.md)

## Relationships

### Inherits From

- [OSContainer](driverkit/oscontainer.md)

## See Also

### HID Device Data

- [IOHIDDigitizerCollection](hiddriverkit/iohiddigitizercollection.md)
- [com.apple.developer.hid.virtual.device](bundleresources/entitlements/com.apple.developer.hid.virtual.device.md)
- [Low-Level Information](hiddriverkit/low-level-information.md)