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
- UUID :
- # The vendor ID that identifies the vendor of the input device.
- Int :
- # The product ID that identifies the product type of the input device.
- Int :
- # The device name that together with the Vendor ID identifies a specific device
- # archetype.
- String :
- }