Função SkipPointerFrameMessages (winuser.h)

Determina qual quadro de entrada de ponteiro gerou a mensagem recuperada mais recentemente para o ponteiro especificado e descarta todas as mensagens de entrada de ponteiro enfileiradas (não obtidas) geradas do mesmo quadro de entrada de ponteiro. Se um aplicativo tiver recuperado informações para um quadro inteiro usando a função GetPointerFrameInfo , a função GetPointerFrameInfoHistory ou uma de suas variantes específicas de tipo, ele poderá usar essa função para evitar recuperar e descartar mensagens restantes desse quadro um por um.

Sintaxe

BOOL SkipPointerFrameMessages(
  [in] UINT32 pointerId
);

Parâmetros

[in] pointerId

Identificador do ponteiro. As mensagens pendentes serão ignoradas para o quadro que inclui a entrada recuperada mais recentemente para esse 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

Os dispositivos de modo paralelo podem relatar a entrada de ponteiro em quadros, ou seja, eles podem relatar o estado e a posição de todos os ponteiros desse dispositivo em um único relatório de entrada para o sistema. O ideal é que os aplicativos exibam todo o quadro como uma única entrada, a menos que os requisitos específicos do aplicativo determinem o contrário.

A função SkipPointerFrameMessages pode ser usada em conjunto com a função GetPointerFrameInfo (ou uma de suas variantes específicas de tipo) para consumir quadros inteiros como uma única entrada.

Quando um aplicativo vê uma mensagem de ponteiro, ele pode usar a função GetPointerFrameInfo para recuperar todo o quadro de entrada do ponteiro ao qual a mensagem de ponteiro pertence, obtendo assim uma exibição atualizada de todos os ponteiros atualmente pertencentes à janela. Observe que o quadro retornado contém apenas ponteiros que atualmente pertencem à mesma janela que o ponteiro especificado.

Depois de recuperar todo o quadro de informações, o aplicativo pode chamar a função SkipPointerFrameMessages para ignorar as mensagens de ponteiro restantes associadas a esse quadro que estão pendentes de recuperação. Isso economiza ao aplicativo a sobrecarga de recuperar e processar as mensagens restantes uma a uma.

Aviso A função SkipPointerFrameMessages deve ser usada somente quando o chamador puder ter certeza de que nenhuma outra entidade no thread do chamador (como Manipulação Direta) espera recuperar mensagens de ponteiro pendentes. Por esse motivo, SkipPointerFrameMessages não deve ser usado em conjunto com a Manipulação Direta ao processar várias interações simultâneas.

 

Observe que as informações recuperadas estão associadas ao quadro de ponteiro recuperado mais recentemente pelo thread de chamada. Depois que o thread de chamada recuperar sua próxima mensagem, as informações associadas ao quadro de ponteiro anterior poderão não estar mais disponíveis.

Se o quadro de ponteiro não contiver ponteiros adicionais além do ponteiro especificado, essa função terá êxito sem nenhuma ação.

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.

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

Confira também

Funções