Saltar al contenido principal
Obtiene el índice de usuario de XInput asignado al dispositivo de entrada, si existe.

Sintaxis

Parámetros

index   _Out_
Tipo: uint32_t*
Recibe el índice de usuario de XInput de base cero (de 0 a 3) del dispositivo. Si el dispositivo no tiene un índice de usuario de XInput, se establece en 0.

Valor devuelto

Tipo: bool true si el dispositivo tiene actualmente un índice de usuario de XInput; de lo contrario, false.

Comentarios

El índice de usuario de XInput es la ranura de mando que usa la API de XInput para identificar un mando, que normalmente corresponde al indicador de jugador que se muestra en el mando. Use este método para correlacionar un dispositivo de GameInput con el mando al que hace referencia el mismo índice de usuario en XInput, por ejemplo, al migrar un título de XInput a GameInput mando a mando. Solo los dispositivos que se exponen a través de XInput tienen un índice de usuario. Otros dispositivos, como los teclados, los mouse y la mayoría de los mandos de juego HID, devuelven false. Los dispositivos agregados nunca tienen un índice de usuario de XInput. Cuando un dispositivo se desconecta, se libera su índice de usuario y el método devuelve false. A diferencia de la mayoría de las propiedades del dispositivo, el índice de usuario de XInput puede cambiar mientras el dispositivo está conectado. Cuando cambia, GameInput notifica a las devoluciones de llamada de dispositivo registradas con el valor GameInputDeviceEventXInputIndexUpdated de GameInputDeviceEvent. Vuelva a llamar a GetXInputDeviceIndex desde la devolución de llamada para obtener el nuevo índice.

Requisitos

Encabezado: GameInput.h Biblioteca: gameinput.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Consulte también

Información general de GameInput
IGameInputDevice
GameInputDeviceEvent
IGameInput::RegisterDeviceCallback

Historial de versiones

Última modificación el 6 de noviembre de 2026