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.

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

Confira também

Funções