Función GetTouchInputInfo (winuser.h)
Recupera información detallada sobre las entradas táctiles asociadas a un identificador de entrada táctil determinado.
Sintaxis
BOOL GetTouchInputInfo(
[in] HTOUCHINPUT hTouchInput,
[in] UINT cInputs,
[out] PTOUCHINPUT pInputs,
[in] int cbSize
);
Parámetros
[in] hTouchInput
Identificador de entrada táctil recibido en el LPARAM de un mensaje táctil. Se produce un error en la función ERROR_INVALID_HANDLE si este identificador no es válido. Tenga en cuenta que el identificador no es válido después de que se haya usado en una llamada correcta a CloseTouchInputHandle o después de pasarlo a DefWindowProc, PostMessage, SendMessage o una de sus variantes.
[in] cInputs
Número de estructuras de la matriz pInputs . Lo ideal es que sea igual al número de puntos táctiles asociados al mensaje, tal como se indica en el mensaje WPARAM. Si cInputs es menor que el número de puntos táctiles, la función seguirá siendo correcta y rellenará el búfer pInputs con información sobre los puntos táctiles de cInputs .
[out] pInputs
Puntero a una matriz de estructuras TOUCHINPUT para recibir información sobre los puntos táctiles asociados al controlador de entrada táctil especificado.
[in] cbSize
Tamaño, en bytes, de una única estructura TOUCHINPUT . Si cbSize no es el tamaño de una única estructura TOUCHINPUT , se produce un error en la función con ERROR_INVALID_PARAMETER.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero. Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, use la función GetLastError .
Comentarios
La llamada a CloseTouchInputHandle no liberará memoria asociada a los valores recuperados en una llamada a GetTouchInputInfo. Los valores de las estructuras pasadas a GetTouchInputInfo serán válidos hasta que los elimine.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winuser.h (incluir Windows.h) |
| Library | User32.lib |
| Archivo DLL | User32.dll |
| Conjunto de API | ext-ms-win-ntuser-misc-l1-2-0 (introducido en Windows 8.1) |