Syntax
Parameters
deviceRootId _Out_Type: APP_LOCAL_DEVICE_ID* Receives the application-local ID of the root device node.
Return value
Type: voidRemarks
The root device ID is an application-local ID that identifies the root device node for composite devices. This allows applications to reason about the relationship of individual devices. For example, some gaming keyboards work around the legacy USB limit of eight simultaneous keystrokes by exposing themselves as a composite device with multiple keyboard nodes. These nodes are merged into the “system” keyboard, so this is usually transparent to the user. But when processing per-keyboard input with the GameInput API, understanding this relationship helps applications avoid improper assumptions (for example, that a keystroke always comes from a specific device) when mapping functions to keystrokes. Devices that report the same root device ID belong to the same composite device. If the device isn’t one of several interfaces on a composite device, the root device ID is the same as the ID returned by IGameInputDevice::GetDeviceId. In GameInput v3 and earlier, this information was available from thedeviceRootId member of the GameInputDeviceInfo structure returned by IGameInputDevice::GetDeviceInfo.
Requirements
Header: GameInput.h Library: gameinput.lib Supported platforms: Windows, XBOX One family consoles and XBOX Series consolesSee also
Overview of GameInputIGameInputDevice
IGameInputDevice::GetDeviceId
IGameInputDevice::GetContainerId
APP_LOCAL_DEVICE_ID