Fungsi GetPointerTouchInfoHistory (winuser.h)

Mendapatkan informasi berbasis sentuhan yang terkait dengan input individu, jika ada, yang digabungkan ke dalam pesan saat ini untuk penunjuk yang ditentukan (jenis PT_TOUCH). Input terbaru disertakan dalam riwayat yang dikembalikan dan sama dengan input terbaru yang dikembalikan oleh fungsi GetPointerTouchInfo .

Sintaks

BOOL GetPointerTouchInfoHistory(
  [in]            UINT32             pointerId,
  [in, out]       UINT32             *entriesCount,
  [out, optional] POINTER_TOUCH_INFO *touchInfo
);

Parameter

[in] pointerId

Pengidentifikasi penunjuk untuk mengambil informasi.

[in, out] entriesCount

Penunjuk ke variabel yang menentukan jumlah struktur dalam buffer tempat touchInfo menunjuk. Jika GetPointerTouchInfoHistory berhasil, entriesCount diperbarui dengan jumlah total struktur yang tersedia. Jumlah total struktur yang tersedia sama dengan bidang historyCount dalam struktur POINTER_INFO yang dikembalikan oleh panggilan ke GetPointerInfo atau GetPointerTouchInfo.

[out, optional] touchInfo

Alamat array struktur POINTER_TOUCH_INFO untuk menerima informasi penunjuk. Parameter ini bisa NULL jika *entriesCount adalah nol.

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

Jika aplikasi tidak memproses pesan input pointer secepat yang dihasilkan, beberapa gerakan mungkin digabungkan. Ketika aplikasi menerima pesan penunjuk yang dapat digabungkan (dari jenis PT_TOUCH), aplikasi dapat menggunakan fungsi GetPointerTouchInfoHistory untuk mengambil informasi untuk semua input individu, jika ada, yang digabungkan ke dalam pesan. Perhatikan bahwa informasi yang diambil dikaitkan dengan pesan penunjuk yang terakhir diambil oleh utas panggilan. Setelah utas panggilan mengambil pesan berikutnya, informasi yang terkait dengan pesan sebelumnya mungkin tidak lagi tersedia.

Informasi yang diambil muncul dalam urutan kronologis terbalik, dengan entri terbaru di baris pertama array yang dikembalikan. Entri terbaru sama dengan yang dikembalikan oleh fungsi GetPointerTouchInfo .

Jika jumlah baris dalam buffer yang disediakan tidak cukup untuk menyimpan semua entri riwayat yang tersedia, fungsi ini berhasil dengan buffer yang berisi entri terbaru dan *entriesCount yang berisi jumlah total entri yang tersedia.

Jika bingkai penunjuk tidak berisi penunjuk tambahan selain penunjuk yang ditentukan, fungsi ini berhasil dan hanya mengembalikan informasi untuk penunjuk yang ditentukan.

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

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

Jika penunjuk yang ditentukan bukan tipe 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 (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll

Lihat juga

Fungsi

GetPointerFrameTouchInfo

GetPointerFrameTouchInfoHistory

GetPointerTouchInfo