Функция GetPointerTouchInfo (winuser.h)
Возвращает сведения на основе сенсорного ввода для указанного указателя (типа PT_TOUCH), связанного с текущим сообщением.
Синтаксис
BOOL GetPointerTouchInfo(
[in] UINT32 pointerId,
[out] POINTER_TOUCH_INFO *touchInfo
);
Параметры
[in] pointerId
Идентификатор указателя, для которого требуется получить сведения.
[out] touchInfo
Адрес структуры POINTER_TOUCH_INFO для получения сведений о указателе касания.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение не равно нулю.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
GetPointerTouchInfo извлекает сведения для одного указателя (типа PT_TOUCH), связанного с сообщением указателя.
Используйте GetPointerFrameTouchInfo для получения сведений о кадре, связанных с сообщением, для набора указателей.
Сведения, возвращаемые GetPointerTouchInfo , связаны с последним сообщением указателя, извлеченным вызывающим потоком. Когда вызывающий поток извлекает следующее сообщение, сведения, связанные с предыдущим сообщением, могут быть недоступны.
Если приложение не обрабатывает входные сообщения указателя так быстро, как они создаются, некоторые сообщения могут быть объединены в сообщение WM_POINTERUPDATE . Используйте GetPointerTouchInfoHistory , чтобы получить журнал сообщений из последнего сообщения WM_POINTERUPDATE .
Если сведения, связанные с сообщением, больше недоступны, эта функция завершается сбоем с последней ошибкой ERROR_NO_DATA.
Если вызывающий поток не владеет окном, в которое было доставлено сообщение указателя, эта функция завершается ошибкой с последней ошибкой ERROR_ACCESS_DENIED. Обратите внимание, что это может быть окно, в которое изначально были доставлены входные данные, или окно, в которое было перенаправлено сообщение.
Если указанный указатель не имеет типа PT_TOUCH, эта функция завершается ошибкой с последней ошибкой ERROR_DATATYPE_MISMATCH.
Требования
| Минимальная версия клиента | Windows 8 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winuser.h (включая Windows.h) |
| Библиотека | User32.lib |
| DLL | User32.dll |