estructura XINPUT_GAMEPAD (xinput.h)
Describe el estado actual del controlador.
Sintaxis
typedef struct _XINPUT_GAMEPAD {
WORD wButtons;
BYTE bLeftTrigger;
BYTE bRightTrigger;
SHORT sThumbLX;
SHORT sThumbLY;
SHORT sThumbRX;
SHORT sThumbRY;
} XINPUT_GAMEPAD, *PXINPUT_GAMEPAD;
Miembros
wButtons
Máscara de bits de los botones digitales del dispositivo, como se indica a continuación. Un bit establecido indica que se presiona el botón correspondiente.
| Botón Dispositivo | Máscara |
|---|---|
| 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 establecidos pero no definidos anteriormente están reservados y su estado no está definido.
bLeftTrigger
Valor actual del control analógico del desencadenador izquierdo. El valor está comprendido entre 0 y 255.
bRightTrigger
Valor actual del control analógico del desencadenador derecho. El valor está comprendido entre 0 y 255.
sThumbLX
Valor del eje X del stick analógico izquierdo. Cada uno de los miembros del eje de la barra digital es un valor con signo entre -32768 y 32767 que describe la posición del stick analógico. Un valor de 0 está centrado. Los valores negativos indican hacia abajo o hacia la izquierda. Los valores positivos se suscriben o a la derecha. Las constantes XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE o XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE se pueden usar como un valor positivo y negativo para filtrar una entrada de stick analógico.
sThumbLY
Valor del eje Y del stick analógico izquierdo. El valor está comprendido entre -32768 y 32767.
sThumbRX
Valor del eje x del stick analógico derecho. El valor está comprendido entre -32768 y 32767.
sThumbRY
Valor del eje y del stick analógico derecho. El valor está comprendido entre -32768 y 32767.
Comentarios
La estructura XINPUT_STATE usa esta estructura al sondear los cambios en el estado del controlador.
La asignación específica del botón a la función de juego varía según el tipo de juego.
La constante XINPUT_GAMEPAD_TRIGGER_THRESHOLD se puede usar como valor que bLeftTrigger y bRightTrigger deben ser mayores que para registrarse como presionado. Esto es opcional, pero a menudo deseable. Los botones del controlador no manifiestan la comunicación cruzada.
Requisitos
| Requisito | Valor |
|---|---|
| Header | xinput.h |