Función SkipPointerFrameMessages (winuser.h)

Determina qué marco de entrada de puntero generó el mensaje recuperado más recientemente para el puntero especificado y descarta los mensajes de entrada de puntero en cola (no devueltos) generados a partir del mismo marco de entrada de puntero. Si una aplicación ha recuperado información para un fotograma completo mediante la función GetPointerFrameInfo , la función GetPointerFrameInfoHistory o una de sus variantes específicas del tipo, puede usar esta función para evitar recuperar y descartar los mensajes restantes de ese marco uno por uno.

Sintaxis

BOOL SkipPointerFrameMessages(
  [in] UINT32 pointerId
);

Parámetros

[in] pointerId

Identificador del puntero. Los mensajes pendientes se omitirán para el marco que incluye la entrada recuperada más recientemente para este puntero.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Los dispositivos en modo paralelo pueden notificar la entrada de puntero en fotogramas, es decir, pueden notificar el estado y la posición de todos los punteros de ese dispositivo en un único informe de entrada al sistema. Lo ideal es que las aplicaciones vean todo el fotograma como una sola entrada a menos que los requisitos específicos de la aplicación dicten lo contrario.

La función SkipPointerFrameMessages se puede usar junto con la función GetPointerFrameInfo (o una de sus variantes específicas del tipo) para consumir fotogramas completos como una sola entrada.

Cuando una aplicación ve un mensaje de puntero, puede usar la función GetPointerFrameInfo para recuperar todo el marco de entrada del puntero al que pertenece el mensaje de puntero, por lo que se obtiene una vista actualizada de todos los punteros que pertenecen actualmente a la ventana. Tenga en cuenta que el marco devuelto contiene solo punteros que pertenecen actualmente a la misma ventana que el puntero especificado.

Después de recuperar todo el marco de información, la aplicación puede llamar a la función SkipPointerFrameMessages para omitir los mensajes de puntero restantes asociados a este marco que están pendientes de recuperación. Esto ahorra a la aplicación la sobrecarga de recuperar y procesar los mensajes restantes uno por uno.

Advertencia La función SkipPointerFrameMessages solo se debe usar cuando el autor de la llamada puede estar seguro de que ninguna otra entidad del subproceso del autor de la llamada (como Manipulación directa) espera recuperar mensajes de puntero pendientes. Por este motivo, SkipPointerFrameMessages no se debe usar junto con la manipulación directa al procesar varias interacciones simultáneas.

 

Tenga en cuenta que la información recuperada está asociada al marco de puntero más recientemente recuperado por el subproceso que realiza la llamada. Una vez que el subproceso que realiza la llamada recupera su siguiente mensaje, es posible que la información asociada al marco de puntero anterior ya no esté disponible.

Si el marco de puntero no contiene punteros adicionales además del puntero especificado, esta función se realiza correctamente sin ninguna acción.

Si el subproceso que realiza la llamada no posee la ventana a la que se ha entregado el mensaje de puntero, esta función produce el último error establecido en ERROR_ACCESS_DENIED.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll

Vea también

Funciones