Función GetPointerPenInfoHistory (winuser.h)

Obtiene la información basada en lápiz asociada a las entradas individuales, si las hay, que se fusionaron en el mensaje actual para el puntero especificado (de tipo PT_PEN). La entrada más reciente se incluye en el historial devuelto y es la misma que la entrada más reciente devuelta por la función GetPointerPenInfo .

Sintaxis

BOOL GetPointerPenInfoHistory(
  [in]            UINT32           pointerId,
  [in, out]       UINT32           *entriesCount,
  [out, optional] POINTER_PEN_INFO *penInfo
);

Parámetros

[in] pointerId

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

[in, out] entriesCount

Puntero a una variable que especifica el recuento de estructuras en el búfer al que apunta penInfo . Si GetPointerPenInfoHistory se realiza correctamente,triesCount se actualiza con el recuento total de estructuras disponibles. El recuento total de estructuras disponibles es el mismo que el campo historyCount de la estructura POINTER_PEN_INFO devuelta por una llamada a GetPointerPenInfo.

[out, optional] penInfo

Dirección de una matriz de estructuras de POINTER_PEN_INFO para recibir la información del puntero. Este parámetro puede ser NULL si *entriesCount es cero.

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

Si la aplicación no procesa los mensajes de entrada de puntero tan rápido como se generan, es posible que se fusionen algunos movimientos. Cuando una aplicación recibe un mensaje de puntero combinado (de tipo PT_PEN), puede usar la función GetPointerPenInfoHistory para recuperar información de todas las entradas individuales, si las hubiera, que se fusionaron en el mensaje. Tenga en cuenta que la información recuperada está asociada al mensaje de puntero recuperado más recientemente 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 mensaje anterior ya no esté disponible.

La información recuperada aparece en orden cronológico inverso, con la entrada más reciente en la primera fila de la matriz devuelta. La entrada más reciente es la misma que la devuelta por la función GetPointerPenInfo .

Si el recuento de filas del búfer proporcionado no es suficiente para contener todas las entradas del historial disponibles, esta función se realiza correctamente con el búfer que contiene las entradas más recientes y *entriesCount que contiene el recuento total de entradas disponibles.

Si el marco de puntero no contiene punteros adicionales además del puntero especificado, esta función se realiza correctamente y devuelve solo la información del puntero especificado.

Si la información asociada al marco de puntero ya no está disponible, esta función genera el último error establecido en ERROR_NO_DATA.

Si el subproceso que realiza la llamada no posee la ventana (donde se entregó originalmente la entrada o donde se reenvía el mensaje) al que se ha entregado el mensaje de puntero, esta función produce el último error establecido en ERROR_ACCESS_DENIED.

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

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

GetPointerFramePenInfo

GetPointerFramePenInfoHistory

GetPointerPenInfo