Pular para o conteúdo principal
Obtém o ID local do aplicativo do nó de dispositivo raiz do dispositivo de entrada.

Sintaxe

Parâmetros

deviceRootId   _Out_
Tipo: APP_LOCAL_DEVICE_ID*
Recebe o ID local do aplicativo do nó de dispositivo raiz.

Valor retornado

Tipo: void

Comentários

O ID do dispositivo raiz é um ID local do aplicativo que identifica o nó de dispositivo raiz de dispositivos compostos. Isso permite que os aplicativos entendam a relação entre dispositivos individuais. Por exemplo, alguns teclados para jogos contornam o limite USB legado de oito pressionamentos de tecla simultâneos expondo-se como um dispositivo composto com vários nós de teclado. Esses nós são mesclados no teclado do “sistema”, de modo que isso geralmente é transparente para o usuário. Mas, ao processar a entrada por teclado com a API GameInput, entender essa relação ajuda os aplicativos a evitar suposições incorretas (por exemplo, de que um pressionamento de tecla sempre vem de um dispositivo específico) ao mapear funções para pressionamentos de tecla. Os dispositivos que relatam o mesmo ID do dispositivo raiz pertencem ao mesmo dispositivo composto. Se o dispositivo não for uma das várias interfaces em um dispositivo composto, o ID do dispositivo raiz será igual ao ID retornado por IGameInputDevice::GetDeviceId. No GameInput v3 e anteriores, essas informações estavam disponíveis no membro deviceRootId da estrutura GameInputDeviceInfo retornada por IGameInputDevice::GetDeviceInfo.

Requisitos

Cabeçalho: GameInput.h Biblioteca: gameinput.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

Visão geral do GameInput
IGameInputDevice
IGameInputDevice::GetDeviceId
IGameInputDevice::GetContainerId
APP_LOCAL_DEVICE_ID

Histórico de versões

Última modificação em 6 de novembro de 2026