Pular para o conteúdo principal
Obtém o ID local do aplicativo que identifica exclusivamente o dispositivo de entrada.

Sintaxe

Parâmetros

deviceId   _Out_
Tipo: APP_LOCAL_DEVICE_ID*
Recebe o ID local do aplicativo do dispositivo.

Valor retornado

Tipo: void

Comentários

O ID do dispositivo é um ID local do aplicativo: um valor de hash de 256 bits que identifica exclusivamente o dispositivo. Esse ID permanece o mesmo para um determinado dispositivo, mesmo entre execuções de um aplicativo ou reinicializações do sistema, desde que o dispositivo se conecte à mesma porta USB. O hash é gerado em parte a partir de informações específicas do aplicativo chamador e do sistema, portanto o mesmo dispositivo tem IDs diferentes em aplicativos diferentes. Como o ID é estável, você pode armazená-lo para lembrar de um dispositivo, como o controle preferido de um usuário, e depois localizar o objeto de dispositivo correspondente chamando IGameInput::FindDeviceFromId. Para dispositivos que são uma de várias interfaces em um dispositivo composto, use IGameInputDevice::GetDeviceRootId para obter o ID do dispositivo raiz. Se o dispositivo não fizer parte de um dispositivo composto, o ID do dispositivo e o ID do dispositivo raiz serão iguais. No GameInput v3 e anteriores, essas informações estavam disponíveis no membro deviceId 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::GetDeviceRootId
IGameInput::FindDeviceFromId
APP_LOCAL_DEVICE_ID

Histórico de versões

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