Saltar al contenido principal
Recupera información sobre los interruptores de mando genéricos del dispositivo, como los hat switches y los pads direccionales.

Sintaxis

Parámetros

infoArrayCount   _In_
Tipo: uint32_t
Número de elementos de infoArray. Para recuperar todos los interruptores de mando, pase el valor devuelto por GetControllerSwitchCount. infoArray   _Out_writes_to_opt_(infoArrayCount, return)
Tipo: GameInputControllerSwitchInfo*
Puntero a una matriz que recibe una estructura por cada interruptor de mando. Puede ser nullptr, en cuyo caso no se escribe nada y el método devuelve 0.

Valor devuelto

Tipo: uint32_t El número de elementos escritos en infoArray. Es el menor de infoArrayCount y el número de interruptores de mando del dispositivo, o 0 si infoArray es nullptr o el dispositivo no tiene interruptores de mando.

Comentarios

Cada elemento es una estructura GameInputControllerSwitchInfo que describe el tipo del interruptor correspondiente (de 2, 4 u 8 direcciones, como un valor de GameInputSwitchKind) y la etiqueta de cada una de sus posiciones. Llame a GetControllerSwitchCount para obtener el número de interruptores de mando, asigne una matriz de ese tamaño y, a continuación, llame a GetControllerSwitchInfo para rellenarla. Si infoArrayCount es menor que el número de interruptores de mando, solo se escriben los primeros infoArrayCount elementos. Los interruptores de mando de un dispositivo no cambian mientras el dispositivo está conectado, por lo que puede consultarlos una vez y almacenar en caché el resultado. El elemento i de la matriz de información describe el interruptor situado en el índice i de la matriz devuelta por IGameInputReading::GetControllerSwitchState para las lecturas de este dispositivo. En el siguiente ejemplo se muestra cómo recuperar los interruptores de mando de un dispositivo.
En GameInput v3 y versiones anteriores, esta información estaba disponible en el miembro controllerSwitchInfo de la estructura GameInputControllerInfo, a la que hacía referencia el miembro controllerInfo de la estructura GameInputDeviceInfo devuelta por IGameInputDevice::GetDeviceInfo.

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
GetControllerSwitchCount
GameInputControllerSwitchInfo
GameInputSwitchKind
IGameInputReading::GetControllerSwitchState
IGameInputDevice

Historial de versiones

Última modificación el 6 de noviembre de 2026