Функция GetTouchInputInfo (winuser.h)
Извлекает подробные сведения о сенсорных входных данных, связанных с определенным дескриптором сенсорного ввода.
Синтаксис
BOOL GetTouchInputInfo(
[in] HTOUCHINPUT hTouchInput,
[in] UINT cInputs,
[out] PTOUCHINPUT pInputs,
[in] int cbSize
);
Параметры
[in] hTouchInput
Дескриптор сенсорного ввода, полученный в LPARAM сенсорного сообщения. Если этот дескриптор недопустим, функция завершается сбоем с ERROR_INVALID_HANDLE . Обратите внимание, что дескриптор недопустим после успешного вызова CloseTouchInputHandle или после передачи в DefWindowProc, PostMessage, SendMessage или один из их вариантов.
[in] cInputs
Число структур в массиве pInputs . В идеале это должно быть по крайней мере равно количеству точек касания, связанных с сообщением, как указано в сообщении WPARAM. Если значение cInputs меньше числа точек касания, функция по-прежнему будет успешно выполняться и заполнять буфер pInputs сведениями о точках касания cInputs .
[out] pInputs
Указатель на массив структур TOUCHINPUT для получения сведений о точках касания, связанных с указанным дескриптором ввода сенсорного ввода.
[in] cbSize
Размер (в байтах) одной структуры TOUCHINPUT . Если cbSize не имеет размер одной структуры TOUCHINPUT , функция завершается сбоем с ERROR_INVALID_PARAMETER.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение. Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, используйте функцию GetLastError .
Комментарии
Вызов CloseTouchInputHandle не освобождает память, связанную со значениями, извлеченными при вызове GetTouchInputInfo. Значения в структурах, передаваемых в GetTouchInputInfo , будут действительны до их удаления.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winuser.h (включая Windows.h) |
| Библиотека | User32.lib |
| DLL | User32.dll |
| Набор API | ext-ms-win-ntuser-misc-l1-2-0 (представлено в Windows 8.1) |