Fungsi XInputGetKeystroke (xinput.h)

Mengambil peristiwa input gamepad.

Sintaks

DWORD XInputGetKeystroke(
  DWORD             dwUserIndex,
  DWORD             dwReserved,
  PXINPUT_KEYSTROKE pKeystroke
);

Parameter

dwUserIndex

[in] Indeks gamer yang masuk yang terkait dengan perangkat. Dapat berupa nilai dalam rentang 0–XUSER_MAX_COUNT − 1, atau XUSER_INDEX_ANY untuk mengambil peristiwa input berikutnya yang tersedia dari pengguna mana pun.

dwReserved

[in] Dipesan

pKeystroke

[keluar] Arahkan ke struktur XINPUT_KEYSTROKE yang menerima peristiwa input.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika tidak ada tombol baru yang ditekan, nilai yang dikembalikan ERROR_EMPTY.

Jika pengontrol tidak tersambung atau pengguna belum mengaktifkannya, nilai yang dikembalikan ERROR_DEVICE_NOT_CONNECTED. Lihat bagian Keterangan di bawah ini.

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

Pengontrol nirkabel tidak dianggap aktif pada saat startup sistem, dan panggilan ke salah satu fungsi XInput sebelum pengontrol nirkabel dibuat aktif kembali ERROR_DEVICE_NOT_CONNECTED. Judul game harus memeriksa kode pengembalian dan bersiaplah untuk menangani kondisi ini. Pengontrol kabel diaktifkan secara otomatis ketika disisipkan. Pengontrol nirkabel diaktifkan ketika daya pengguna pada pengontrol.

Persyaratan Platform

Windows 8 (XInput 1.4), DirectX SDK (XInput 1.3)

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	xinput.h
Pustaka	Xinput.lib
DLL	Xinput1_4.dll

Lihat juga

XINPUT_KEYSTROKE

Fungsi XInput