Fungsi GetRawInputData (winuser.h)

Mengambil input mentah dari perangkat yang ditentukan.

Sintaksis

UINT GetRawInputData(
  [in]            HRAWINPUT hRawInput,
  [in]            UINT      uiCommand,
  [out, optional] LPVOID    pData,
  [in, out]       PUINT     pcbSize,
  [in]            UINT      cbSizeHeader
);

Parameter-parameternya

[in] hRawInput

Jenis: HRAWINPUT

Handel ke struktur RAWINPUT . Ini berasal dari lParam di WM_INPUT.

[in] uiCommand

Jenis: UINT

Bendera perintah. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
RID_HEADER 0x10000005	Dapatkan informasi header dari struktur RAWINPUT .
RID_INPUT 0x10000003	Dapatkan data mentah dari struktur RAWINPUT .

[out, optional] pData

Jenis: LPVOID

Penunjuk ke data yang berasal dari struktur RAWINPUT . Ini tergantung pada nilai uiCommand. Penunjuk harus diratakan pada batas DWORD (32-bit).

Jika pDataADALAH NULL, ukuran buffer yang diperlukan dikembalikan dalam *pcbSize.

[in, out] pcbSize

Jenis: PUINT

Ukuran, dalam byte, data dalam pData.

[in] cbSizeHeader

Jenis: UINT

Ukurannya, dalam byte, dari struktur RAWINPUTHEADER .

Mengembalikan nilai

Jenis: UINT

Jika pDataADALAH NULL dan fungsi berhasil, nilai yang dikembalikan adalah 0. Jika pData bukan NULL dan fungsi berhasil, nilai yang dikembalikan adalah jumlah byte yang disalin ke dalam pData.

Jika ada kesalahan, nilai yang dikembalikan adalah (UINT)-1.

Komentar

GetRawInputData mendapatkan input mentah satu struktur RAWINPUT pada satu waktu. Sebaliknya, GetRawInputBuffer mendapatkan array struktur RAWINPUT .

Persyaratan

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

Lihat juga

Konseptual

GetRawInputBuffer

RAWINPUT

RAWINPUTHEADER

Input Mentah

Referensi