Compartilhar via


Função GetTouchInputInfo (winuser.h)

Recupera informações detalhadas sobre entradas de toque associadas a um identificador de entrada por toque específico.

Sintaxe

BOOL GetTouchInputInfo(
  [in]  HTOUCHINPUT hTouchInput,
  [in]  UINT        cInputs,
  [out] PTOUCHINPUT pInputs,
  [in]  int         cbSize
);

Parâmetros

[in] hTouchInput

O identificador de entrada por toque recebido no LPARAM de uma mensagem de toque. A função falhará com ERROR_INVALID_HANDLE se esse identificador não for válido. Observe que o identificador não é válido depois de ter sido usado em uma chamada bem-sucedida para CloseTouchInputHandle ou depois de ter sido passado para DefWindowProc, PostMessage, SendMessage ou uma de suas variantes.

[in] cInputs

O número de estruturas na matriz pInputs . Idealmente, isso deve ser pelo menos igual ao número de pontos de toque associados à mensagem, conforme indicado na mensagem WPARAM. Se cInputs for menor que o número de pontos de toque, a função ainda terá êxito e preencherá o buffer pInputs com informações sobre pontos de toque cInputs .

[out] pInputs

Um ponteiro para uma matriz de estruturas TOUCHINPUT para receber informações sobre os pontos de toque associados ao identificador de entrada de toque especificado.

[in] cbSize

O tamanho, em bytes, de uma única estrutura TOUCHINPUT . Se cbSize não for o tamanho de uma única estrutura TOUCHINPUT , a função falhará com ERROR_INVALID_PARAMETER.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero. Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, use a função GetLastError .

Comentários

Chamar CloseTouchInputHandle não liberará memória associada aos valores recuperados em uma chamada para GetTouchInputInfo. Os valores em estruturas passadas para GetTouchInputInfo serão válidos até que você os exclua.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-misc-l1-2-0 (introduzido no Windows 8.1)

Confira também

CloseTouchInputHandle

Funções

TOUCHINPUT