Função GetPointerInfo (winuser.h)

Obtém as informações do ponteiro especificado associado à mensagem atual.

Nota Use GetPointerType se você não precisar das informações adicionais expostas por GetPointerInfo.

 

Sintaxe

BOOL GetPointerInfo(
  [in]  UINT32       pointerId,
  [out] POINTER_INFO *pointerInfo
);

Parâmetros

[in] pointerId

O identificador do ponteiro.

[out] pointerInfo

Endereço de uma estrutura POINTER_INFO que recebe as informações do ponteiro.

Retornar valor

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

GetPointerInfo recupera informações para um único ponteiro associado a uma mensagem de ponteiro.

Use GetPointerFrameInfo para recuperar informações de quadro associadas a uma mensagem para um conjunto de ponteiros.

As informações retornadas por GetPointerInfo 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 GetPointerInfoHistory 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.

Requisitos

Requisito	Valor
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
Conjunto de APIs	ext-ms-win-rtcore-ntuser-wmpointer-l1-1-0 (introduzido no Windows 10, versão 10.0.14393)

Confira também

Funções

GetPointerFrameInfo

GetPointerFrameInfoHistory

GetPointerInfoHistory