Fungsi GetGestureInfo (winuser.h)
Mengambil struktur GESTUREINFO yang diberikan handel ke informasi gerakan.
Sintaks
BOOL GetGestureInfo(
[in] HGESTUREINFO hGestureInfo,
[out] PGESTUREINFO pGestureInfo
);
Parameter
[in] hGestureInfo
Penanganan informasi gerakan.
[out] pGestureInfo
Penunjuk ke struktur informasi gerakan.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, gunakan fungsi GetLastError .
Keterangan
Anggota cbSize dari struktur GESTUREINFO yang diteruskan ke fungsi harus diatur sebelum fungsi dipanggil. Jika tidak, panggilan ke GetLastError akan mengembalikan ERROR_INVALID_PARAMETER (87 dalam desimal). Jika aplikasi memproses pesan WM_GESTURE , aplikasi bertanggung jawab untuk menutup handel menggunakan CloseGestureInfoHandle. Kegagalan untuk melakukannya dapat mengakibatkan kebocoran memori proses.
Jika pesan diteruskan ke DefWindowProc, atau diteruskan menggunakan salah satu kelas PostMessage atau SendMessage fungsi API, handel ditransfer dengan pesan dan tidak perlu ditutup oleh aplikasi.
Contoh
GESTUREINFO gestureInfo = {0};
gestureInfo.cbSize = sizeof(gestureInfo);
BOOL bResult = GetGestureInfo((HGESTUREINFO)lParam, &gestureInfo);
if (!bResult){
DWORD err = GetLastError();
}
Persyaratan
| Klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winuser.h (sertakan Windows.h) |
| Pustaka | User32.lib |
| DLL | User32.dll |
| Set API | ext-ms-win-ntuser-misc-l1-2-0 (diperkenalkan di Windows 8.1) |