XINPUT_GAMEPAD struttura (xinput.h)
Descrive lo stato corrente del controller.
Sintassi
typedef struct _XINPUT_GAMEPAD {
WORD wButtons;
BYTE bLeftTrigger;
BYTE bRightTrigger;
SHORT sThumbLX;
SHORT sThumbLY;
SHORT sThumbRX;
SHORT sThumbRY;
} XINPUT_GAMEPAD, *PXINPUT_GAMEPAD;
Members
wButtons
Maschera di bit dei pulsanti digitali del dispositivo, come indicato di seguito. Un bit impostato indica che il pulsante corrispondente viene premuto.
| Pulsante dispositivo | Maschera |
|---|---|
| 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 |
I bit impostati ma non definiti in precedenza sono riservati e lo stato non è definito.
bLeftTrigger
Valore corrente del controllo analogico del trigger sinistro. Il valore è compreso tra 0 e 255.
bRightTrigger
Valore corrente del controllo analogico del trigger destro. Il valore è compreso tra 0 e 255.
sThumbLX
Valore dell'asse x del pollice sinistro. Ognuno dei membri dell'asse del pollice è un valore firmato compreso tra -32768 e 32767 che descrive la posizione del pollice. Il valore 0 viene centrato. I valori negativi firmano o verso sinistra. I valori positivi si registrano o a destra. Le costanti XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE o XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE possono essere usate come valore positivo e negativo per filtrare un input di un'operatore.
sThumbLY
Valore dell'asse y a sinistra. Il valore è compreso tra -32768 e 32767.
sThumbRX
Valore dell'asse x del pollice destro. Il valore è compreso tra -32768 e 32767.
sThumbRY
Valore dell'asse y del pollice destro. Il valore è compreso tra -32768 e 32767.
Commenti
Questa struttura viene usata dalla struttura XINPUT_STATE durante il polling delle modifiche nello stato del controller.
Il mapping specifico del pulsante alla funzione di gioco varia a seconda del tipo di gioco.
La costante XINPUT_GAMEPAD_TRIGGER_THRESHOLD può essere usata come valore che bLeftTrigger e bRightTrigger deve essere maggiore di quello di registrare come premuto. Questo è facoltativo, ma spesso auspicabile. I pulsanti del controller non manifestano l'intertalk.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | xinput.h |