joyGetPosEx (joystickapi.h)

  • Artikel

Fungsi joyGetPosEx mengkueri joystick untuk posisi dan status tombolnya.

Sintaks

MMRESULT joyGetPosEx(
  UINT        uJoyID,
  LPJOYINFOEX pji
);

Parameter

uJoyID

Pengidentifikasi joystick yang akan dikueri. Nilai yang valid untuk uJoyID berkisar dari nol (JOYSTICKID1) hingga 15.

pji

Penunjuk ke struktur JOYINFOEX yang berisi informasi posisi yang diperluas dan status tombol joystick. Anda harus mengatur anggota dwSize dan dwFlags atau joyGetPosEx akan gagal. Informasi yang dikembalikan dari joyGetPosEx tergantung pada bendera yang Anda tentukan di dwFlags.

Nilai kembali

Mengembalikan JOYERR_NOERROR jika berhasil atau salah satu nilai kesalahan berikut.

Menampilkan kode Deskripsi
MMSYSERR_NODRIVER
 Driver joystick tidak ada.
MMSYSERR_INVALPARAM
 Parameter yang tidak valid diteruskan.
MMSYSERR_BADDEVICEID
 Pengidentifikasi joystick yang ditentukan tidak valid.
JOYERR_UNPLUGGED
 Joystick yang ditentukan tidak terhubung ke sistem.
JOYERR_PARMS
 Pengidentifikasi joystick yang ditentukan tidak valid.

Keterangan

Fungsi ini menyediakan akses ke perangkat yang diperluas seperti pedal kemudi, topi titik pandang, perangkat dengan sejumlah besar tombol, dan sistem koordinat menggunakan hingga enam sumbu. Untuk perangkat joystick yang menggunakan tiga sumbu atau lebih sedikit dan memiliki kurang dari empat tombol, gunakan fungsi joyGetPos .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header joystickapi.h (sertakan Windows.h)
Pustaka Winmm.lib
DLL Winmm.dll

Lihat juga

Joystick

Fungsi Joystick Multimedia