Fungsi GetPointerInfo (winuser.h)

Artikel
08/27/2023

Mendapatkan informasi untuk penunjuk yang ditentukan yang terkait dengan pesan saat ini.

Catatan Gunakan GetPointerType jika Anda tidak memerlukan informasi tambahan yang diekspos oleh GetPointerInfo.

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)

Lihat juga

Fungsi

GetPointerFrameInfo

GetPointerFrameInfoHistory

GetPointerInfoHistory

Bagikan melalui