Fungsi GetPointerPenInfoHistory (winuser.h)

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

Sintaks

BOOL GetPointerPenInfoHistory(
  [in]            UINT32           pointerId,
  [in, out]       UINT32           *entriesCount,
  [out, optional] POINTER_PEN_INFO *penInfo
);

Parameter

[in] pointerId

Pengidentifikasi penunjuk untuk mengambil informasi.

[in, out] entriesCount

Penunjuk ke variabel yang menentukan jumlah struktur dalam buffer tempat penInfo menunjuk. Jika GetPointerPenInfoHistory berhasil, entriesCount diperbarui dengan jumlah total struktur yang tersedia. Jumlah total struktur yang tersedia sama dengan bidang historyCount dalam struktur POINTER_PEN_INFO yang dikembalikan oleh panggilan ke GetPointerPenInfo.

[out, optional] penInfo

Alamat array struktur POINTER_PEN_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 dikoales (dari jenis PT_PEN), aplikasi dapat menggunakan fungsi GetPointerPenInfoHistory 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 GetPointerPenInfo .

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_PEN, fungsi ini gagal dengan kesalahan terakhir yang diatur ke ERROR_DATATYPE_MISMATCH.

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

GetPointerFramePenInfo

GetPointerFramePenInfoHistory

GetPointerPenInfo