Fungsi GetPointerInfo (winuser.h)
Mendapatkan informasi untuk penunjuk yang ditentukan yang terkait dengan pesan saat ini.
Sintaks
BOOL GetPointerInfo(
[in] UINT32 pointerId,
[out] POINTER_INFO *pointerInfo
);
Parameter
[in] pointerId
Pengidentifikasi penunjuk.
[out] pointerInfo
Alamat struktur POINTER_INFO yang menerima informasi penunjuk.
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
GetPointerInfo mengambil informasi untuk satu penunjuk yang terkait dengan pesan penunjuk.
Gunakan GetPointerFrameInfo 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 GetPointerInfoHistory 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.
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 |
Set API | ext-ms-win-rtcore-ntuser-wmpointer-l1-1-0 (diperkenalkan dalam Windows 10, versi 10.0.14393) |