Fungsi GetPointerTouchInfo (winuser.h)

Mendapatkan informasi berbasis sentuhan untuk penunjuk yang ditentukan (jenis PT_TOUCH) yang terkait dengan pesan saat ini.

Sintaks

BOOL GetPointerTouchInfo(
  [in]  UINT32             pointerId,
  [out] POINTER_TOUCH_INFO *touchInfo
);

Parameter

[in] pointerId

Pengidentifikasi pointer untuk mengambil informasi.

[out] touchInfo

Alamat struktur POINTER_TOUCH_INFO untuk menerima informasi pointer khusus sentuhan.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

GetPointerTouchInfo mengambil informasi untuk satu penunjuk (jenis PT_TOUCH) yang terkait dengan pesan penunjuk.

Gunakan GetPointerFrameTouchInfo untuk mengambil informasi bingkai yang terkait dengan pesan untuk sekumpulan pointer.

Informasi yang dikembalikan oleh GetPointerTouchInfo dikaitkan dengan pesan pointer terbaru yang diambil oleh utas panggilan. Ketika pesan berikutnya diambil oleh utas panggilan, informasi yang terkait dengan pesan sebelumnya mungkin tidak lagi tersedia.

Jika aplikasi tidak memproses pesan input pointer secepat yang dihasilkan, beberapa pesan mungkin digabungkan ke dalam pesan WM_POINTERUPDATE . Gunakan GetPointerTouchInfoHistory untuk mengambil riwayat pesan dari pesan WM_POINTERUPDATE terbaru.

Jika informasi yang terkait dengan pesan tidak lagi tersedia, fungsi ini gagal dengan kesalahan terakhir yang diatur ke ERROR_NO_DATA.

Jika utas panggilan tidak memiliki jendela tempat pesan penunjuk dikirimkan, fungsi ini gagal dengan kesalahan terakhir yang diatur ke ERROR_ACCESS_DENIED. Perhatikan bahwa ini mungkin jendela tempat input awalnya dikirimkan atau mungkin jendela tempat pesan diteruskan.

Jika penunjuk yang ditentukan bukan berjenis PT_TOUCH, fungsi ini gagal dengan kesalahan terakhir yang diatur ke ERROR_DATATYPE_MISMATCH.

Persyaratan

Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll

Lihat juga

Fungsi

GetPointerFrameTouchInfo

GetPointerFrameTouchInfoHistory

GetPointerTouchInfoHistory