Funzione GetPointerTouchInfoHistory (winuser.h)

Ottiene le informazioni basate sul tocco associate ai singoli input, se presenti, che sono stati coalecati nel messaggio corrente per il puntatore specificato (di tipo PT_TOUCH). L'input più recente è incluso nella cronologia restituita e corrisponde all'input più recente restituito dalla funzione GetPointerTouchInfo .

Sintassi

BOOL GetPointerTouchInfoHistory(
  [in]            UINT32             pointerId,
  [in, out]       UINT32             *entriesCount,
  [out, optional] POINTER_TOUCH_INFO *touchInfo
);

Parametri

[in] pointerId

Identificatore del puntatore per il quale recuperare le informazioni.

[in, out] entriesCount

Puntatore a una variabile che specifica il numero di strutture nel buffer a cui punta touchInfo. Se GetPointerTouchInfoHistory ha esito positivo, entriesCount viene aggiornato con il numero totale di strutture disponibili. Il numero totale di strutture disponibili corrisponde al campo historyCount nella struttura POINTER_INFO restituita da una chiamata a GetPointerInfo o GetPointerTouchInfo.

[out, optional] touchInfo

Indirizzo di una matrice di strutture POINTER_TOUCH_INFO per ricevere le informazioni sul puntatore. Questo parametro può essere NULL se *entriesCount è zero.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se l'applicazione non elabora i messaggi di input del puntatore con la stessa velocità con cui vengono generati, è possibile che alcuni spostamenti vengano uniti. Quando un'applicazione riceve un messaggio di puntatore coalescable (di tipo PT_TOUCH), può usare la funzione GetPointerTouchInfoHistory per recuperare informazioni per tutti i singoli input, se presenti, che sono stati uniti nel messaggio. Si noti che le informazioni recuperate sono associate al messaggio del puntatore recuperato più di recente dal thread chiamante. Dopo che il thread chiamante recupera il messaggio successivo, le informazioni associate al messaggio precedente potrebbero non essere più disponibili.

Le informazioni recuperate vengono visualizzate in ordine cronologico inverso, con la voce più recente nella prima riga della matrice restituita. La voce più recente è uguale a quella restituita dalla funzione GetPointerTouchInfo .

Se il numero di righe nel buffer specificato non è sufficiente per contenere tutte le voci della cronologia disponibili, questa funzione ha esito positivo con il buffer contenente le voci più recenti e *entriesCount contenente il numero totale di voci disponibili.

Se il frame del puntatore non contiene puntatori aggiuntivi oltre al puntatore specificato, questa funzione ha esito positivo e restituisce solo le informazioni per il puntatore specificato.

Se le informazioni associate al frame del puntatore non sono più disponibili, questa funzione ha esito negativo con l'ultimo errore impostato su ERROR_NO_DATA.

Se il thread chiamante non è proprietario della finestra (in cui l'input è stato originariamente recapitato o in cui è stato inoltrato il messaggio) a cui è stato recapitato il messaggio del puntatore, questa funzione ha esito negativo con l'ultimo errore impostato su ERROR_ACCESS_DENIED.

Se il puntatore specificato non è di tipo PT_TOUCH, questa funzione ha esito negativo con l'ultimo errore impostato su ERROR_DATATYPE_MISMATCH.

Requisiti

Vedi anche

Funzioni

GetPointerFrameTouchInfo

GetPointerFrameTouchInfoHistory

GetPointerTouchInfo