INPUT_OBJECT

DeviceIdentifierInput

Identifies an input device or input device archetype. One of the following combination of values must be set, in order of priority:

  • instanceId
    • Identifies a connected device with the specified instance GUID.
  • vendorId + productId
    • Identifies a connected device with the specified Vendor ID and Product ID combination.
  • vendorId + deviceName
    • Identifies the device archetype with the specified Vendor ID and Device Name combination. This does not need to refer to a connected device.

Input profiles are always registered to the device archetype consisting of the Vendor ID and Device Name of the device. instanceId and vendorId + productId inputs are used only to find such an archetype from the list of connected devices. Combinations are strictly prioritized, for exampleif instanceId is set, this will override any identfier with vendorId. For combinations that require a connected device, if such a device is not found, there is no fallback to a lower priority combination, and an error will occur. For example, if instanceId, vendorId, and deviceName are all set, and a device with the provided instanceId could not be found, this will result in an error.

  • input DeviceIdentifierInput {
  • # The instance ID that identifies the input device
  • instanceId: UUID
  • # The vendor ID that identifies the vendor of the input device.
  • vendorId: Int
  • # The product ID that identifies the product type of the input device.
  • productId: Int
  • # The device name that together with the Vendor ID identifies a specific device
  • # archetype.
  • deviceName: String
  • }