struktur XINPUT_CAPABILITIES (xinput.h)

Menjelaskan kemampuan pengontrol yang terhubung. Fungsi XInputGetCapabilities mengembalikan XINPUT_CAPABILITIES.

Sintaks

typedef struct _XINPUT_CAPABILITIES {
  BYTE             Type;
  BYTE             SubType;
  WORD             Flags;
  XINPUT_GAMEPAD   Gamepad;
  XINPUT_VIBRATION Vibration;
} XINPUT_CAPABILITIES, *PXINPUT_CAPABILITIES;

Anggota

Type

Jenis pengontrol. Ini harus menjadi salah satu nilai berikut.

Nilai	Deskripsi
XINPUT_DEVTYPE_GAMEPAD	Perangkat ini adalah pengontrol permainan.

SubType

Subjenis pengontrol permainan. Lihat Subjenis XINPUT dan Pengontrol untuk daftar subjenis yang diizinkan.

Catatan Untuk pembatasan penggunaan nilai subjenis ini, lihat Keterangan. Lebih banyak subjenis dapat ditambahkan di masa mendatang.

 

Flags

Fitur pengontrol.

Nilai	Deskripsi
XINPUT_CAPS_VOICE_SUPPORTED	Perangkat memiliki perangkat suara terintegrasi.
XINPUT_CAPS_FFB_SUPPORTED	Perangkat mendukung fungsionalitas umpan balik paksa. Perhatikan bahwa fitur umpan balik paksa di luar rumble saat ini tidak didukung melalui XINPUT di Windows.
XINPUT_CAPS_WIRELESS	Perangkat nirkabel.
XINPUT_CAPS_PMD_SUPPORTED	Perangkat mendukung modul plug-in. Perhatikan bahwa modul plug-in seperti perangkat input teks (TID) saat ini tidak didukung melalui XINPUT di Windows.
XINPUT_CAPS_NO_NAVIGATION	Perangkat tidak memiliki tombol navigasi menu (START, BACK, DPAD).

Gamepad

XINPUT_GAMEPAD struktur yang menjelaskan fitur pengontrol yang tersedia dan resolusi kontrol.

Vibration

XINPUT_VIBRATION struktur yang menjelaskan fungsionalitas dan resolusi getaran yang tersedia.

Keterangan

XInputGetCapabilities mengembalikan XINPUT_CAPABILITIES untuk menunjukkan karakteristik dan fungsionalitas yang tersedia dari pengontrol tertentu.

XInputGetCapabilities mengatur anggota struktur untuk menunjukkan input mana yang didukung perangkat. Untuk kontrol status biner, seperti tombol digital, bit yang sesuai mencerminkan apakah kontrol didukung oleh perangkat atau tidak. Untuk kontrol proporsional, seperti thumbstick, nilai menunjukkan resolusi untuk kontrol tersebut. Beberapa jumlah bit yang paling tidak signifikan mungkin tidak diatur, menunjukkan bahwa kontrol tidak memberikan resolusi ke tingkat tersebut.

Anggota SubType menunjukkan subjenis pengontrol tertentu yang ada. Game dapat mendeteksi subjenis pengontrol dan menyempurnakan penanganan input atau output pengontrol berdasarkan subjenis yang sangat cocok untuk genre game mereka. Misalnya, game balap mobil mungkin memeriksa keberadaan pengontrol roda untuk memberikan kontrol yang lebih baik atas mobil yang dikendarai. Namun, judul tidak boleh menonaktifkan atau mengabaikan perangkat berdasarkan subjenisnya. Subjenis yang tidak dikenali oleh permainan atau permainan yang tidak disetel secara khusus harus diperlakukan sebagai pengontrol standar (XINPUT_DEVSUBTYPE_GAMEPAD).

Driver Windows XUSB lama melaporkan informasi kemampuan yang tidak lengkap, terutama untuk perangkat nirkabel. Driver XUSB Windows terbaru memberikan dukungan penuh untuk perangkat kabel dan nirkabel, dan bendera kemampuan yang lebih lengkap dan akurat.

Persyaratan

Persyaratan	Nilai
Header	xinput.h

Lihat juga

XINPUT_GAMEPAD

XINPUT_VIBRATION

Struktur XInput

XInputGetCapabilities