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)

Consulte también

CloseTouchInputHandle

Funciones

TOUCHINPUT