Função GetPointerTouchInfo (winuser.h)
Obtém as informações baseadas em toque para o ponteiro especificado (do tipo PT_TOUCH) associado à mensagem atual.
Sintaxe
BOOL GetPointerTouchInfo(
[in] UINT32 pointerId,
[out] POINTER_TOUCH_INFO *touchInfo
);
Parâmetros
[in] pointerId
Um identificador do ponteiro para o qual recuperar informações.
[out] touchInfo
Endereço de uma estrutura POINTER_TOUCH_INFO para receber as informações de ponteiro específicas do toque.
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, chame GetLastError.
Comentários
GetPointerTouchInfo recupera informações de um único ponteiro (do tipo PT_TOUCH) associado a uma mensagem de ponteiro.
Use GetPointerFrameTouchInfo para recuperar informações de quadro associadas a uma mensagem para um conjunto de ponteiros.
As informações retornadas por GetPointerTouchInfo estão associadas à mensagem de ponteiro mais recente recuperada pelo thread de chamada. Quando a próxima mensagem é recuperada pelo thread de chamada, as informações associadas à mensagem anterior podem não estar mais disponíveis.
Se o aplicativo não processar mensagens de entrada de ponteiro tão rápido quanto são geradas, algumas mensagens poderão ser agrupadas em uma mensagem de WM_POINTERUPDATE . Use GetPointerTouchInfoHistory para recuperar o histórico de mensagens da mensagem de WM_POINTERUPDATE mais recente.
Se as informações associadas à mensagem não estiverem mais disponíveis, essa função falhará com o último erro definido como ERROR_NO_DATA.
Se o thread de chamada não possuir a janela à qual a mensagem de ponteiro foi entregue, essa função falhará com o último erro definido como ERROR_ACCESS_DENIED. Observe que essa pode ser a janela para a qual a entrada foi entregue originalmente ou pode ser uma janela para a qual a mensagem foi encaminhada.
Se o ponteiro especificado não for do tipo PT_TOUCH, essa função falhará com o último erro definido como ERROR_DATATYPE_MISMATCH.
Requisitos
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |