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
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winuser.h (include Windows.h) |
| Libreria | User32.lib |
| DLL | User32.dll |