Contents

IOHIDElement

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

Declaration

class IOHIDElement;

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

Accessing the Element’s Value

Getting Minimum and Maximum Values

Getting the Element’s Timestamp

Managing the Element Hierarchy

Getting Report Information

Identifying the Element

Getting the Element Flags

Committing Changes to Elements

Instance Methods

See Also

HID Device Data