struktur XINPUT_GAMEPAD (xinput.h)

Menjelaskan status pengontrol saat ini.

Sintaks

typedef struct _XINPUT_GAMEPAD {
  WORD  wButtons;
  BYTE  bLeftTrigger;
  BYTE  bRightTrigger;
  SHORT sThumbLX;
  SHORT sThumbLY;
  SHORT sThumbRX;
  SHORT sThumbRY;
} XINPUT_GAMEPAD, *PXINPUT_GAMEPAD;

Anggota

wButtons

Bitmask tombol digital perangkat, sebagai berikut. Bit yang ditetapkan menunjukkan bahwa tombol yang sesuai ditekan.

Tombol perangkat	Bitmask
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

 

Bit yang diatur tetapi tidak ditentukan di atas dicadangkan, dan statusnya tidak terdefinisi.

bLeftTrigger

Nilai kontrol analog pemicu kiri saat ini. Nilainya antara 0 dan 255.

bRightTrigger

Nilai saat ini dari kontrol analog pemicu yang tepat. Nilainya antara 0 dan 255.

sThumbLX

Nilai sumbu x thumbstick kiri. Masing-masing anggota sumbu thumbstick adalah nilai yang ditandatangani antara -32768 dan 32767 yang menjelaskan posisi thumbstick. Nilai 0 dipusatkan. Nilai negatif menandakan ke bawah atau ke kiri. Nilai positif mendaftar atau ke kanan. Konstanta XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE atau XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE dapat digunakan sebagai nilai positif dan negatif untuk memfilter input thumbstick.

sThumbLY

Nilai sumbu y thumbstick kiri. Nilainya antara -32768 dan 32767.

sThumbRX

Nilai sumbu x thumbstick kanan. Nilainya antara -32768 dan 32767.

sThumbRY

Nilai sumbu y thumbstick kanan. Nilainya antara -32768 dan 32767.

Keterangan

Struktur ini digunakan oleh struktur XINPUT_STATE saat polling untuk perubahan status pengontrol.

Pemetaan spesifik fungsi tombol ke game bervariasi tergantung pada jenis permainan.

Konstanta XINPUT_GAMEPAD_TRIGGER_THRESHOLD dapat digunakan sebagai nilai yang bLeftTrigger dan bRightTrigger harus lebih besar dari untuk mendaftar seperti yang ditekan. Ini opsional, tetapi sering diinginkan. Tombol pengontrol tidak memanifestasikan crosstalk.

Persyaratan

Persyaratan	Nilai
Header	xinput.h

Lihat juga

XINPUT_STATE

Struktur XInput

XInputGetState