Fungsi RegisterRawInputDevices (winuser.h)

  • Artikel

Mendaftarkan perangkat yang menyediakan data input mentah.

Sintaks

BOOL RegisterRawInputDevices(
  [in] PCRAWINPUTDEVICE pRawInputDevices,
  [in] UINT             uiNumDevices,
  [in] UINT             cbSize
);

Parameter

[in] pRawInputDevices

Jenis: PCRAWINPUTDEVICE

Array struktur RAWINPUTDEVICE yang mewakili perangkat yang menyediakan input mentah.

[in] uiNumDevices

Jenis: UINT

Jumlah struktur RAWINPUTDEVICE yang diarahkan oleh pRawInputDevices.

[in] cbSize

Jenis: UINT

Ukuran, dalam byte, dari struktur RAWINPUTDEVICE .

Nilai kembali

Jenis: BOOL

TRUE jika fungsi berhasil; jika tidak, FALSE. Jika fungsi gagal, hubungi GetLastError untuk informasi selengkapnya.

Keterangan

Untuk menerima pesan WM_INPUT , aplikasi harus terlebih dahulu mendaftarkan perangkat input mentah menggunakan RegisterRawInputDevices. Secara default, aplikasi tidak menerima input mentah.

Untuk menerima pesan WM_INPUT_DEVICE_CHANGE , aplikasi harus menentukan bendera RIDEV_DEVNOTIFY untuk setiap kelas perangkat yang ditentukan oleh bidang usUsagePage dan usUsage dari struktur RAWINPUTDEVICE . Secara default, aplikasi tidak menerima pemberitahuan WM_INPUT_DEVICE_CHANGE untuk kedatangan dan penghapusan perangkat input mentah.

Jika struktur RAWINPUTDEVICE memiliki bendera RIDEV_REMOVE yang ditetapkan dan parameter hwndTarget tidak diatur ke NULL, maka validasi parameter akan gagal.

Hanya satu jendela per kelas perangkat input mentah yang dapat didaftarkan untuk menerima input mentah dalam proses (jendela yang diteruskan dalam panggilan terakhir ke RegisterRawInputDevices). Karena itu, RegisterRawInputDevices tidak boleh digunakan dari pustaka, karena dapat mengganggu logika pemrosesan input mentah yang sudah ada dalam aplikasi yang memuatnya.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header winuser.h (termasuk Windows.h)
Pustaka User32.lib
DLL User32.dll
Set API ext-ms-win-ntuser-rawinput-l1-1-0 (diperkenalkan dalam Windows 10, versi 10.0.14393)

Lihat juga

Konseptual

RAWINPUTDEVICE

Input Mentah

Referensi

WM_INPUT