XINPUT_GAMEPAD struttura (xinput.h)

  • Articolo

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

Vedi anche

XINPUT_STATE

Strutture XInput

XInputGetState