Struktur JOYINFOEX (joystickapi.h)

Struktur JOYINFOEX berisi informasi yang diperluas tentang posisi joystick, posisi sudut pandang, dan status tombol.

Sintaks

typedef struct joyinfoex_tag {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwXpos;
  DWORD dwYpos;
  DWORD dwZpos;
  DWORD dwRpos;
  DWORD dwUpos;
  DWORD dwVpos;
  DWORD dwButtons;
  DWORD dwButtonNumber;
  DWORD dwPOV;
  DWORD dwReserved1;
  DWORD dwReserved2;
} JOYINFOEX, *PJOYINFOEX, *NPJOYINFOEX, *LPJOYINFOEX;

Anggota

dwSize

Ukuran, dalam byte, dari struktur ini.

dwFlags

Bendera yang menunjukkan informasi valid yang dikembalikan dalam struktur ini. Anggota yang tidak berisi informasi yang valid diatur ke nol. Bendera berikut didefinisikan:

Bendera	Deskripsi
JOY_RETURNALL	Setara dengan mengatur semua bit JOY_RETURN kecuali JOY_RETURNRAWDATA.
JOY_RETURNBUTTONS	Anggota dwButtons berisi informasi yang valid tentang status setiap tombol joystick.
JOY_RETURNCENTERED	Pusatkan posisi netral joystick ke nilai tengah setiap sumbu gerakan.
JOY_RETURNPOV	Anggota dwPOV berisi informasi yang valid tentang kontrol titik pandang, yang dinyatakan dalam unit diskrit.
JOY_RETURNPOVCTS	Anggota dwPOV berisi informasi yang valid tentang kontrol titik pandang yang dinyatakan dalam unit derajat seratus yang berkelanjutan.
JOY_RETURNR	Anggota dwRpos berisi data pedal kemudi yang valid. Informasi ini mewakili sumbu (keempat) lainnya.
JOY_RETURNRAWDATA	Data yang disimpan dalam struktur ini adalah pembacaan joystick yang tidak dikalibrasi.
JOY_RETURNU	Anggota dwUpos berisi data yang valid untuk sumbu kelima joystick, jika sumbu tersebut tersedia, atau mengembalikan nol sebaliknya.
JOY_RETURNV	Anggota dwVpos berisi data yang valid untuk sumbu keenam joystick, jika sumbu tersebut tersedia, atau mengembalikan nol sebaliknya.
JOY_RETURNX	Anggota dwXpos berisi data yang valid untuk koordinat x joystick.
JOY_RETURNY	Anggota dwYpos berisi data yang valid untuk koordinat y joystick.
JOY_RETURNZ	Anggota dwZpos berisi data yang valid untuk koordinat z joystick.

 

Bendera berikut menyediakan data untuk mengkalibrasi joystick dan ditujukan untuk aplikasi kalibrasi kustom.

Bendera	Deskripsi
JOY_CAL_READ3	Baca koordinat x- , y-, dan z dan simpan nilai mentah dalam dwXpos, dwYpos, dan dwZpos.
JOY_CAL_READ4	Baca informasi kemudi dan koordinat x, y-, dan z dan simpan nilai mentah di dwXpos, dwYpos, dwZpos, dan dwRpos.
JOY_CAL_READ5	Baca informasi kemudi dan x-, y-, z-, dan Anda-koordinat dan simpan nilai mentah di dwXpos, dwYpos, dwZpos, dwRpos, dan dwUpos.
JOY_CAL_READ6	Baca data sumbu v mentah jika ada driver mini joystick yang akan memberikan data. Mengembalikan nol jika tidak.
JOY_CAL_READALWAYS	Baca port joystick meskipun driver tidak mendeteksi perangkat.
JOY_CAL_READRONLY	Baca informasi kemudi jika ada driver mini joystick yang akan memberikan data dan menyimpan nilai mentah di dwRpos. Mengembalikan nol jika tidak.
JOY_CAL_READXONLY	Baca koordinat x dan simpan nilai mentah (tidak dikalibrasi) dalam dwXpos.
JOY_CAL_READXYONLY	Membaca koordinat x- dan y dan menempatkan nilai mentah dalam dwXpos dan dwYpos.
JOY_CAL_READYONLY	Membaca koordinat y dan menyimpan nilai mentah dalam dwYpos.
JOY_CAL_READZONLY	Baca koordinat z dan simpan nilai mentah dalam dwZpos.
JOY_CAL_READUONLY	Baca u-coordinate jika ada driver mini joystick yang akan memberikan data dan menyimpan nilai mentah di dwUpos. Mengembalikan nol jika tidak.
JOY_CAL_READVONLY	Baca koordinat v jika ada driver mini joystick yang akan memberikan data dan menyimpan nilai mentah dalam dwVpos. Mengembalikan nol jika tidak.

dwXpos

Koordinat X saat ini.

dwYpos

Koordinat Y saat ini.

dwZpos

Koordinat Z saat ini.

dwRpos

Posisi kemudi saat ini atau sumbu joystick keempat.

dwUpos

Posisi sumbu kelima saat ini.

dwVpos

Posisi sumbu keenam saat ini.

dwButtons

Status saat ini dari 32 tombol joystick. Nilai anggota ini dapat diatur ke kombinasi bendera JOY_BUTTON n , di mana n adalah nilai dalam rentang 1 hingga 32 yang sesuai dengan tombol yang ditekan.

dwButtonNumber

Nomor tombol saat ini yang ditekan.

dwPOV

Posisi kontrol titik pandang saat ini. Nilai untuk anggota ini berada dalam rentang 0 hingga 35.900. Nilai-nilai ini mewakili sudut, dalam derajat, dari setiap tampilan dikalikan dengan 100.

dwReserved1

Dipesan; jangan gunakan.

dwReserved2

Dipesan; jangan gunakan.

Keterangan

Nilai anggota dwSize juga digunakan untuk mengidentifikasi nomor versi untuk struktur ketika diteruskan ke fungsi joyGetPosEx .

Sebagian besar perangkat dengan kontrol titik pandang hanya memiliki lima posisi. Saat bendera JOY_RETURNPOV diatur, posisi ini dilaporkan dengan menggunakan konstanta berikut:

Bendera Titik Tampilan	Deskripsi
JOY_POVBACKWARD	Topi titik pandang ditekan mundur. Nilai 18.000 mewakili orientasi 180,00 derajat (ke belakang).
JOY_POVCENTERED	Topi titik pandang berada di posisi netral. Nilai -1 berarti topi titik pandang tidak memiliki sudut untuk dilaporkan.
JOY_POVFORWARD	Topi titik pandang ditekan ke depan. Nilai 0 mewakili orientasi 0,00 derajat (lurus ke depan).
JOY_POVLEFT	Topi titik pandang sedang ditekan ke kiri. Nilai 27.000 mewakili orientasi 270,00 derajat (90,00 derajat ke kiri).
JOY_POVRIGHT	Topi titik pandang ditekan ke kanan. Nilai 9.000 mewakili orientasi 90,00 derajat (di sebelah kanan).

 

Driver joystick default saat ini mendukung lima arah diskrit ini. Jika aplikasi hanya dapat menerima nilai titik tampilan yang ditentukan, aplikasi harus menggunakan bendera JOY_RETURNPOV. Jika aplikasi dapat menerima pembacaan gelar lainnya, aplikasi harus menggunakan bendera JOY_RETURNPOVCTS untuk mendapatkan data berkelanjutan jika tersedia. Bendera JOY_RETURNPOVCTS juga mendukung konstanta JOY_POV yang digunakan dengan bendera JOY_RETURNPOV.

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	joystickapi.h (sertakan Windows.h)

Lihat juga

Joystick

Struktur Joystick Multimedia

joyGetPosEx