Constants

Keys that represent properties of a paticular device. Can be added to your matching dictionary when refining searches for HID devices.

Please note:

kIOHIDPrimaryUsageKey and kIOHIDPrimaryUsagePageKey are no longer rich enough to describe a device's capabilities. Take, for example, a device that describes both a keyboard and a mouse in the same descriptor. The previous behavior was to only describe the keyboard behavior with the primary usage and usage page. Needless to say, this would sometimes cause a program interested in mice to skip this device when matching.

Thus we have added 3 additional keys:

kIOHIDDeviceUsageKey

kIOHIDDeviceUsagePageKey

kIOHIDDeviceUsagePairsKey

kIOHIDDeviceUsagePairsKey is used to represent an array of dictionaries containing key/value pairs referenced by kIOHIDDeviceUsageKey and kIOHIDDeviceUsagePageKey. These usage pairs describe all application type collections (behaviors) defined by the device.

An application intersted in only matching on one criteria would only add the kIOHIDDeviceUsageKey and kIOHIDDeviceUsagePageKey keys to the matching dictionary. If it is interested in a device that has multiple behaviors, the application would instead add an array or dictionaries referenced by kIOHIDDeviceUsagePairsKey to his matching dictionary.

HID Element Dictionary Keys

HID Element Dictionary Keys

Keys that represent properties of a particular elements.

These keys can also be added to a matching dictionary when searching for elements via copyMatchingElements.

HID Element Match Keys

HID Element Match Keys

Keys used for matching particular elements.

These keys should only be used with a matching dictionary when searching for elements via copyMatchingElements.

kIOHIDElementCalibrationDeadZoneMaxKey

kIOHIDElementCalibrationDeadZoneMaxKey

The maximum bounds near the midpoint of a logical value in which the value is ignored.

The dead zone property is used to allow for slight differences in the idle value returned by an element.

Available in OS X v10.5 and later.

kIOHIDElementCalibrationDeadZoneMinKey

kIOHIDElementCalibrationDeadZoneMinKey

The minimum bounds near the midpoint of a logical value in which the value is ignored.

The dead zone property is used to allow for slight differences in the idle value returned by an element.

Available in OS X v10.5 and later.

kIOHIDElementCalibrationDeadZoneMinKey

kIOHIDElementCalibrationDeadZoneMinKey

The maximum bounds near the midpoint of a logical value in which the value is ignored.

The dead zone property is used to allow for slight differences in the idle value returned by an element.

Available in OS X v10.5 and later.

kIOHIDElementCalibrationGranularityKey

kIOHIDElementCalibrationGranularityKey

The scale or level of detail returned in a calibrated element value.

Values are rounded off such that if granularity=0.1, values after calibration are 0, 0.1, 0.2, 0.3, etc.

Available in OS X v10.5 and later.

kIOHIDElementCalibrationMaxKey

kIOHIDElementCalibrationMaxKey

The maximum bounds for a calibrated value.

Available in OS X v10.5 and later.

kIOHIDElementCalibrationMinKey

kIOHIDElementCalibrationMinKey

The minimum bounds for a calibrated value.

Available in OS X v10.5 and later.

kIOHIDElementCalibrationSaturationMaxKey

kIOHIDElementCalibrationSaturationMaxKey

The maximum tolerance to be used when calibrating a logical element value.

The saturation property is used to allow for slight differences in the minimum and maximum value returned by an element.

Available in OS X v10.5 and later.

kIOHIDElementCalibrationSaturationMinKey

kIOHIDElementCalibrationSaturationMinKey

The mininum tolerance to be used when calibrating a logical element value.

The saturation property is used to allow for slight differences in the minimum and maximum value returned by an element.

Available in OS X v10.5 and later.

kIOHIDElementCookieKey

kIOHIDElementCookieKey

Keys that represent properties of a particular elements.

These keys can also be added to a matching dictionary when searching for elements via copyMatchingElements.

Available in OS X v10.0 and later.

kIOHIDElementCookieMinKey

kIOHIDElementCookieMinKey

Keys used for matching particular elements.

These keys should only be used with a matching dictionary when searching for elements via copyMatchingElements.

Available in OS X v10.5 and later.

kIOHIDElementKey

kIOHIDElementKey

Keys that represents an element property.

Property for a HID Device or element dictionary. Elements can be heirarchical, so they can contain other elements.

Available in OS X v10.0 and later.

kIOHIDTransportKey

kIOHIDTransportKey

Keys that represent properties of a paticular device.

Keys that represent properties of a paticular device. Can be added to your matching dictionary when refining searches for HID devices.

Please note:

kIOHIDPrimaryUsageKey and kIOHIDPrimaryUsagePageKey are no longer rich enough to describe a device's capabilities. Take, for example, a device that describes both a keyboard and a mouse in the same descriptor. The previous behavior was to only describe the keyboard behavior with the primary usage and usage page. Needless to say, this would sometimes cause a program interested in mice to skip this device when matching.

Thus we have added 3 additional keys:

kIOHIDDeviceUsageKey

kIOHIDDeviceUsagePageKey

kIOHIDDeviceUsagePairsKey

kIOHIDDeviceUsagePairsKey is used to represent an array of dictionaries containing key/value pairs referenced by kIOHIDDeviceUsageKey and kIOHIDDeviceUsagePageKey. These usage pairs describe all application type collections (behaviors) defined by the device.

An application intersted in only matching on one criteria would only add the kIOHIDDeviceUsageKey and kIOHIDDeviceUsagePageKey keys to the matching dictionary. If it is interested in a device that has multiple behaviors, the application would instead add an array or dictionaries referenced by kIOHIDDeviceUsagePairsKey to his matching dictionary.