Función GetPointerPenInfo (winuser.h)

Obtiene la información basada en lápiz del puntero especificado (de tipo PT_PEN) asociado al mensaje actual.

Sintaxis

BOOL GetPointerPenInfo(
  [in]  UINT32           pointerId,
  [out] POINTER_PEN_INFO *penInfo
);

Parámetros

[in] pointerId

Identificador del puntero para el que se va a recuperar información.

[out] penInfo

Dirección de una estructura de POINTER_PEN_INFO para recibir la información de puntero específica del lápiz.

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

GetPointerPenInfo recupera información de un único puntero (de tipo PT_PEN) asociado a un mensaje de puntero.

Use GetPointerFramePenInfo para recuperar información de marco 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 siguiente mensaje se recupera mediante el subproceso que realiza la llamada, 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, es posible que algunos mensajes se fusionen en un mensaje de WM_POINTERUPDATE . Use GetPointerPenInfoHistory 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 un error con 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.

Si el puntero especificado no es de tipo PT_PEN, esta función produce un error con el último error establecido en ERROR_DATATYPE_MISMATCH.

Requisitos

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 (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll

Vea también

Funciones

GetPointerFramePenInfo

GetPointerFramePenInfoHistory

GetPointerPenInfoHistory