Fungsi XInputGetState (xinput.h)
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.
Persyaratan Platform
Windows 8 (XInput 1.4), Directx SDK (XInput 1.3), Windows Vista (XInput 9.1.0)Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | xinput.h |
Pustaka | Xinput.lib; Xinput9_1_0.lib |
DLL | Xinput1_4.dll; Xinput9_1_0.dll; Xinputuap.dll |