> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XINPUT_GAMEPAD

> XINPUT_GAMEPAD

# XINPUT\_GAMEPAD

Describe el estado actual del mando.

## Sintaxis

```cpp theme={null}
typedef struct XINPUT_GAMEPAD {  
    WORD wButtons;  
    BYTE bLeftTrigger;  
    BYTE bRightTrigger;  
    SHORT sThumbLX;  
    SHORT sThumbLY;  
    SHORT sThumbRX;  
    SHORT sThumbRY;  
} XINPUT_GAMEPAD  
```

### Miembros

*wButtons*\
Tipo: WORD

Máscara de bits de los botones digitales del dispositivo. Un bit establecido indica que el botón correspondiente está presionado.

| Botón del dispositivo            | Máscara de bits |
| -------------------------------- | --------------- |
| XINPUT\_GAMEPAD\_DPAD\_UP        | 0x0001          |
| XINPUT\_GAMEPAD\_DPAD\_DOWN      | 0x0002          |
| XINPUT\_GAMEPAD\_DPAD\_LEFT      | 0x0004          |
| XINPUT\_GAMEPAD\_DPAD\_RIGHT     | 0x0008          |
| XINPUT\_GAMEPAD\_START           | 0x0010          |
| XINPUT\_GAMEPAD\_BACK            | 0x0020          |
| XINPUT\_GAMEPAD\_LEFT\_THUMB     | 0x0040          |
| XINPUT\_GAMEPAD\_RIGHT\_THUMB    | 0x0080          |
| XINPUT\_GAMEPAD\_LEFT\_SHOULDER  | 0x0100          |
| XINPUT\_GAMEPAD\_RIGHT\_SHOULDER | 0x0200          |
| XINPUT\_GAMEPAD\_A               | 0x1000          |
| XINPUT\_GAMEPAD\_B               | 0x2000          |
| XINPUT\_GAMEPAD\_X               | 0x4000          |
| XINPUT\_GAMEPAD\_Y               | 0x8000          |

Los bits que están establecidos pero no definidos anteriormente están reservados y su estado es indefinido.

*bLeftTrigger*\
Tipo: BYTE

El valor actual del control analógico del gatillo izquierdo. El valor está entre 0 y 255.

*bRightTrigger*\
Tipo: BYTE

El valor actual del control analógico del gatillo derecho. El valor está entre 0 y 255.

*sThumbLX*\
Tipo: SHORT

Valor del eje X de la palanca izquierda. Cada miembro de eje de palanca es un valor con signo que está entre -32768 y 32767 y describe la posición de la palanca. Un valor de 0 está centrado, los valores negativos significan abajo o a la izquierda, y los valores positivos significan arriba o a la derecha. Las constantes XINPUT\_GAMEPAD\_LEFT\_THUMB\_DEADZONE y XINPUT\_GAMEPAD\_RIGHT\_THUMB\_DEADZONE pueden usarse como valores positivos y negativos para filtrar una entrada de palanca.

*sThumbLY*\
Tipo: SHORT

Valor del eje Y de la palanca izquierda, que está entre -32768 y 32767.

*sThumbRX*\
Tipo: SHORT

Valor del eje X de la palanca derecha, que está entre -32768 y 32767.

*sThumbRY*\
Tipo: SHORT

Valor del eje Y de la palanca derecha, que está entre -32768 y 32767.

## Comentarios

Esta estructura la usa la estructura [XINPUT\_STATE](/reference/input/xinputongameinput/structs/xinput_state) durante el sondeo de cambios en el estado del mando.

La asignación específica de un botón a una función del juego varía según el tipo de juego.

La constante XINPUT\_GAMEPAD\_TRIGGER\_THRESHOLD puede usarse como el valor que *bLeftTrigger* y *bRightTrigger* deben superar para registrarse como presionados. Esto es opcional, pero a menudo deseable.

## Requisitos

**Encabezado:** XInputOnGameInput.h

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Portabilidad de XInput a GameInput](/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XINPUT_STATE](/es/reference/input/xinputongameinput/structs/xinput_state.md)
- [XInputOnGameInput](/es/reference/input/xinputongameinput/xinputongameinput_members.md)
- [XINPUT_CAPABILITIES](/es/reference/input/xinputongameinput/structs/xinput_capabilities.md)
- [XInputGetCapabilities](/es/reference/input/xinputongameinput/functions/xinputgetcapabilities.md)
- [XInputGetBatteryInformation](/es/reference/input/xinputongameinput/functions/xinputgetbatteryinformation.md)