fungsi joyGetDevCapsA (joystickapi.h)

Fungsi joyGetDevCaps meminta joystick untuk menentukan kemampuannya.

Sintaksis

MMRESULT joyGetDevCapsA(
  UINT_PTR   uJoyID,
  LPJOYCAPSA pjc,
  UINT       cbjc
);

Parameter

uJoyID

Pengidentifikasi joystick yang akan dikueri. Nilai yang valid untuk uJoyID berkisar dari -1 hingga 15. Nilai -1 memungkinkan pengambilan szRegKey anggota struktur JOYCAPS apakah perangkat ada atau tidak.

pjc

Arahkan ke struktur JOYCAPS untuk berisi kemampuan joystick.

cbjc

Ukuran, dalam byte, dari struktur JOYCAPS .

Mengembalikan nilai

Mengembalikan JOYERR_NOERROR jika berhasil atau salah satu nilai kesalahan berikut:

Mengembalikan kode	Deskripsi
MMSYSERR_NODRIVER	Driver joystick tidak ada, atau pengidentifikasi joystick yang ditentukan tidak valid. Pengidentifikasi joystick yang ditentukan tidak valid.
MMSYSERR_INVALPARAM	Parameter yang tidak valid diteruskan.

Komentar

Gunakan fungsi joyGetNumDevs untuk menentukan jumlah perangkat joystick yang didukung oleh driver.

Metode ini gagal ketika melewati nilai yang tidak valid untuk parameter cbjc.

Nota

Header joystickapi.h mendefinisikan joyGetDevCaps sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	joystickapi.h (termasuk Windows.h)
Pustaka	Winmm.lib
DLL	Winmm.dll

Lihat juga

Joysticks
Multimedia Joystick Functions