Fungsi XInputGetState (xinput.h)

Artikel
03/13/2024

Mengambil status pengontrol yang ditentukan saat ini.

Sintaks

DWORD XInputGetState(
  [in]  DWORD        dwUserIndex,
  [out] XINPUT_STATE *pState
);

Parameter

[in] dwUserIndex

Indeks pengontrol pengguna. Dapat berupa nilai dari 0 hingga 3. Untuk informasi tentang bagaimana nilai ini ditentukan dan bagaimana nilai dipetakan ke indikator pada pengontrol, lihat Beberapa Pengontrol.

[out] pState

Penunjuk ke struktur XINPUT_STATE yang menerima status pengontrol saat ini.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika pengontrol tidak tersambung, nilai yang dikembalikan akan ERROR_DEVICE_NOT_CONNECTED.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan yang ditentukan dalam Winerror.h. Fungsi ini tidak menggunakan SetLastError untuk mengatur kode kesalahan terakhir utas panggilan.

Keterangan

Ketika XInputGetState digunakan untuk mengambil data pengontrol, pemicu kiri dan kanan masing-masing dilaporkan secara terpisah. Untuk alasan warisan, ketika DirectInput mengambil data pengontrol, kedua pemicu berbagi sumbu yang sama. Perilaku warisan terlihat dalam Panel Kontrol Perangkat Game saat ini, yang menggunakan DirectInput untuk status pengontrol.