Fungsi GetPointerInfoHistory (winuser.h)

Mendapatkan informasi yang terkait dengan input individu, jika ada, yang digabungkan ke dalam pesan saat ini untuk penunjuk yang ditentukan. Input terbaru disertakan dalam riwayat yang dikembalikan dan sama dengan input terbaru yang dikembalikan oleh fungsi GetPointerInfo .

Sintaks

BOOL GetPointerInfoHistory(
  [in]            UINT32       pointerId,
  [in, out]       UINT32       *entriesCount,
  [out, optional] POINTER_INFO *pointerInfo
);

Parameter

[in] pointerId

Pengidentifikasi penunjuk untuk mengambil informasi.

[in, out] entriesCount

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

[out, optional] pointerInfo

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

Nilai kembali

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, aplikasi dapat menggunakan fungsi GetPointerInfoHistory 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 GetPointerInfo .

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.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus 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

GetPointerFrameInfo

GetPointerFrameInfoHistory

GetPointerInfo