Fungsi GetPointerPenInfo (winuser.h)
Mendapatkan informasi berbasis pena untuk penunjuk yang ditentukan (jenis PT_PEN) yang terkait dengan pesan saat ini.
Sintaks
BOOL GetPointerPenInfo(
[in] UINT32 pointerId,
[out] POINTER_PEN_INFO *penInfo
);
Parameter
[in] pointerId
Pengidentifikasi penunjuk untuk mengambil informasi.
[out] penInfo
Alamat struktur POINTER_PEN_INFO untuk menerima informasi penunjuk khusus pena.
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
GetPointerPenInfo mengambil informasi untuk satu penunjuk (jenis PT_PEN) yang terkait dengan pesan penunjuk.
Gunakan GetPointerFramePenInfo untuk mengambil informasi bingkai yang terkait dengan pesan untuk sekumpulan penunjuk.
Informasi yang dikembalikan oleh GetPointerInfo 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 GetPointerPenInfoHistory 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 merupakan jendela tempat pesan diteruskan.
Jika penunjuk yang ditentukan bukan tipe PT_PEN, 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 |