Skip to main content

XInputGetDeviceId

Recupera a ID do dispositivo para o controle especificado.

Sintaxe

Parâmetros

dwUserIndex   _In_
Tipo: DWORD
Índice do jogador associado ao dispositivo; um valor no intervalo de 0 a XUSER_MAX_COUNT - 1. pDeviceId   _Out_
Tipo: APP_LOCAL_DEVICE_ID*
ID do dispositivo no índice de usuário especificado.

Valor retornado

Tipo: DWORD Se a função recuperar com êxito a ID do dispositivo, ela retornará ERROR_SUCCESS. Se o controle não estiver conectado, a função retornará ERROR_DEVICE_NOT_CONNECTED. Se a função falhar, ela retornará um código de erro Win32.

Comentários

Uma ID de dispositivo local do aplicativo identifica exclusivamente um dispositivo, mesmo entre reinicializações do título ou do sistema. Para obter mais informações, consulte IDs de dispositivo. Para obter mais informações sobre como usar o XInputOnGameInput, consulte O wrapper XInputOnGameInput.

Requisitos

Cabeçalho: XInputOnGameInput.h Biblioteca: xgameruntime.lib Plataformas com suporte: consoles da família XBOX One e consoles XBOX Series

Confira também

Portabilidade do XInput para o GameInput
XInputOnGameInput
Last modified on October 6, 2026