Función GetPointerInfo (winuser.h)

Obtiene la información del puntero especificado asociado al mensaje actual.

Sintaxis

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

Parámetros

[in] pointerId

Identificador del puntero.

[out] pointerInfo

Dirección de una estructura POINTER_INFO que recibe la información del 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

GetPointerInfo recupera información de un único puntero asociado a un mensaje de puntero.

Use GetPointerFrameInfo para recuperar información de fotogramas asociada a un mensaje para un conjunto de punteros.

La información devuelta por GetPointerInfo está asociada al mensaje de puntero más reciente recuperado por el subproceso que realiza la llamada. Cuando el subproceso que realiza la llamada recupera el siguiente mensaje, es posible que la información asociada al mensaje anterior ya no esté disponible.

Si la aplicación no procesa los mensajes de entrada de puntero tan rápido como se generan, algunos mensajes se pueden fusionar en un mensaje de WM_POINTERUPDATE . Use GetPointerInfoHistory para recuperar el historial de mensajes del mensaje WM_POINTERUPDATE más reciente.

Si la información asociada al mensaje ya no está disponible, esta función produce el último error establecido en ERROR_NO_DATA.

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. Tenga en cuenta que puede ser la ventana a la que se entregó originalmente la entrada o puede ser una ventana a la que se reenviaba el mensaje.

Requisitos

Vea también

Funciones

GetPointerFrameInfo

GetPointerFrameInfoHistory

GetPointerInfoHistory