fungsi joySetCapture (joystickapi.h)

  • Artikel

Fungsi joySetCapture menangkap joystick dengan menyebabkan pesannya dikirim ke jendela yang ditentukan.

Sintaks

MMRESULT joySetCapture(
  HWND hwnd,
  UINT uJoyID,
  UINT uPeriod,
  BOOL fChanged
);

Parameter

hwnd

Tangani ke jendela untuk menerima pesan joystick.

uJoyID

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

uPeriod

Frekuensi polling, dalam milidetik.

fChanged

Ubah bendera posisi. Tentukan TRUE untuk parameter ini untuk mengirim pesan hanya ketika posisi berubah dengan nilai yang lebih besar dari ambang pergerakan joystick. Jika tidak, pesan dikirim pada frekuensi polling yang ditentukan dalam uPeriod.

Menampilkan nilai

Mengembalikan JOYERR_NOERROR jika berhasil atau salah satu nilai kesalahan berikut.

Menampilkan kode Deskripsi
MMSYSERR_NODRIVER
 Driver joystick tidak ada.
MMSYSERR_INVALPARAM
 ID joystick atau hwnd tidak valid adalah NULL.
JOYERR_NOCANDO
 Tidak dapat mengambil input joystick karena layanan yang diperlukan (seperti timer Windows) tidak tersedia.
JOYERR_UNPLUGGED
 Joystick yang ditentukan tidak terhubung ke sistem.
JOYERR_PARMS
 ID joystick atau hwnd tidak valid adalah NULL.

Keterangan

Jika joystick yang ditentukan saat ini ditangkap, fungsi mengembalikan perilaku yang tidak terdefinisi. Panggil fungsi joyReleaseCapture untuk melepaskan joystick yang ditangkap, atau hancurkan jendela untuk melepaskan joystick secara otomatis.

Persyaratan

   
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 (termasuk Windows.h)
Pustaka Winmm.lib
DLL Winmm.dll

Lihat juga

Joystick

Fungsi Joystick Multimedia