<!--
{
  "availability" : [
    "macOS: 15.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreHID",
  "identifier" : "/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/init(primaryUsage:deviceUsages:vendorID:productID:transport:product:manufacturer:modelNumber:versionNumber:serialNumber:uniqueID:locationID:localizationCode:isBuiltIn:extraProperties:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "Core HID"
    ],
    "preciseIdentifier" : "s:7CoreHID16HIDDeviceManagerC22DeviceMatchingCriteriaV12primaryUsage12deviceUsages8vendorID07productM09transport0N012manufacturer11modelNumber07versionR006serialR006uniqueM008locationM016localizationCode9isBuiltIn15extraPropertiesAeA8HIDUsageOSg_SayAVGSgs6UInt32VSgA0_AA0C9TransportOSgSSSgA4_A4_s6UInt64VSgA4_A4_A7_AA0c12LocalizationX0OSgSbSgSDySSyXlGSgtcfc"
  },
  "title" : "init(primaryUsage:deviceUsages:vendorID:productID:transport:product:manufacturer:modelNumber:versionNumber:serialNumber:uniqueID:locationID:localizationCode:isBuiltIn:extraProperties:)"
}
-->

# init(primaryUsage:deviceUsages:vendorID:productID:transport:product:manufacturer:modelNumber:versionNumber:serialNumber:uniqueID:locationID:localizationCode:isBuiltIn:extraProperties:)

Creates one set of matching criteria for HID devices.

```
init(primaryUsage: HIDUsage? = nil, deviceUsages: [HIDUsage]? = nil, vendorID: UInt32? = nil, productID: UInt32? = nil, transport: HIDDeviceTransport? = nil, product: String? = nil, manufacturer: String? = nil, modelNumber: String? = nil, versionNumber: UInt64? = nil, serialNumber: String? = nil, uniqueID: String? = nil, locationID: UInt64? = nil, localizationCode: HIDDeviceLocalizationCode? = nil, isBuiltIn: Bool? = nil, extraProperties: Dictionary<String, AnyObject>? = nil)
```

## Parameters

`primaryUsage`

See [`primaryUsage`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/primaryUsage).

`deviceUsages`

See [`deviceUsages`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/deviceUsages).

`vendorID`

See [`vendorID`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/vendorID).

`productID`

See [`productID`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/productID).

`transport`

See [`transport`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/transport).

`product`

See [`product`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/product).

`manufacturer`

See [`manufacturer`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/manufacturer).

`modelNumber`

See [`modelNumber`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/modelNumber).

`versionNumber`

See [`versionNumber`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/versionNumber).

`serialNumber`

See [`serialNumber`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/serialNumber).

`uniqueID`

See [`uniqueID`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/uniqueID).

`locationID`

See [`locationID`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/locationID).

`localizationCode`

See [`localizationCode`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/localizationCode).

`isBuiltIn`

See [`isBuiltIn`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria/isBuiltIn).

`extraProperties`

A catch-all for uncommon or device specific criteria not listed above. This parameter is typically only for advanced users that need additional control over the matching process.

## Discussion

This `init` method is the only way to create matching criteria for discovering HID devices connected to the system. All parameters are optional; if none are specified, every discoverable device is matched.

Created [`HIDDeviceManager.DeviceMatchingCriteria`](/documentation/CoreHID/HIDDeviceManager/DeviceMatchingCriteria) are used by being passed to [`monitorNotifications(matchingCriteria:)`](/documentation/CoreHID/HIDDeviceManager/monitorNotifications(matchingCriteria:)).

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)