---
title: IOHIDDeviceSetInputValueMatching
framework: IOKit
role: symbol
role_heading: Function
platforms: [Mac Catalyst 13.1+, macOS 10.5+]
path: iokit/1588654-iohiddevicesetinputvaluematching
---

# IOHIDDeviceSetInputValueMatching

Sets matching criteria for input values received via IOHIDDeviceRegisterInputValueCallback.

## Declaration

```occ
void IOHIDDeviceSetInputValueMatching(IOHIDDeviceRef device, CFDictionaryRef matching);
```

## Parameters

- `manager`: Reference to an IOHIDDevice.
- `matching`: CFDictionaryRef containg device matching criteria.

## Discussion

Discussion Matching keys are prefixed by kIOHIDElement and declared in <IOKit/hid/IOHIDKeys.h>. Passing a NULL dictionary will result in all devices being enumerated. Any subsequent calls will cause the hid manager to release previously matched input elements and restart the matching process using the revised criteria. If interested in multiple, specific device elements, please defer to using IOHIDDeviceSetInputValueMatchingMultiple.

## See Also

### Miscellaneous

- [IOHIDDeviceClose](iokit/1588668-iohiddeviceclose.md)
- [IOHIDDeviceConformsTo](iokit/1588665-iohiddeviceconformsto.md)
- [IOHIDDeviceCopyMatchingElements](iokit/1588671-iohiddevicecopymatchingelements.md)
- [IOHIDDeviceCopyValueMultiple](iokit/1588652-iohiddevicecopyvaluemultiple.md)
- [IOHIDDeviceCopyValueMultipleWithCallback](iokit/1588655-iohiddevicecopyvaluemultiplewith.md)
- [IOHIDDeviceCreate](iokit/1588663-iohiddevicecreate.md)
- [IOHIDDeviceGetProperty](iokit/1588648-iohiddevicegetproperty.md)
- [IOHIDDeviceGetReport](iokit/1588659-iohiddevicegetreport.md)
- [IOHIDDeviceGetReportWithCallback](iokit/1588662-iohiddevicegetreportwithcallback.md)
- [IOHIDDeviceGetService](iokit/1588646-iohiddevicegetservice.md)
- [IOHIDDeviceGetTypeID](iokit/1588664-iohiddevicegettypeid.md)
- [IOHIDDeviceGetValue](iokit/1588657-iohiddevicegetvalue.md)
- [IOHIDDeviceGetValueWithCallback](iokit/1588647-iohiddevicegetvaluewithcallback.md)
- [IOHIDDeviceOpen](iokit/1588670-iohiddeviceopen.md)
- [IOHIDDeviceRegisterInputReportCallback](iokit/1588666-iohiddeviceregisterinputreportca.md)
- [IOHIDDeviceRegisterInputValueCallback](iokit/1588672-iohiddeviceregisterinputvaluecal.md)
- [IOHIDDeviceRegisterRemovalCallback](iokit/1588673-iohiddeviceregisterremovalcallba.md)
- [IOHIDDeviceScheduleWithRunLoop](iokit/1588660-iohiddeviceschedulewithrunloop.md)
- [IOHIDDeviceSetInputValueMatchingMultiple](iokit/1588645-iohiddevicesetinputvaluematching.md)
- [IOHIDDeviceSetProperty](iokit/1588653-iohiddevicesetproperty.md)
- [IOHIDDeviceSetReport](iokit/1588656-iohiddevicesetreport.md)
- [IOHIDDeviceSetReportWithCallback](iokit/1588661-iohiddevicesetreportwithcallback.md)
- [IOHIDDeviceSetValue](iokit/1588651-iohiddevicesetvalue.md)
- [IOHIDDeviceSetValueMultiple](iokit/1588669-iohiddevicesetvaluemultiple.md)
- [IOHIDDeviceSetValueMultipleWithCallback](iokit/1588658-iohiddevicesetvaluemultiplewithc.md)
- [IOHIDDeviceSetValueWithCallback](iokit/1588667-iohiddevicesetvaluewithcallback.md)
- [IOHIDDeviceUnscheduleFromRunLoop](iokit/1588650-iohiddeviceunschedulefromrunloop.md)
