Funzione GetPointerInfoHistory (winuser.h)
Ottiene le informazioni associate ai singoli input, se presenti, che sono stati uniti nel messaggio corrente per il puntatore specificato. L'input più recente è incluso nella cronologia restituita e corrisponde all'input più recente restituito dalla funzione GetPointerInfo .
Sintassi
BOOL GetPointerInfoHistory(
[in] UINT32 pointerId,
[in, out] UINT32 *entriesCount,
[out, optional] POINTER_INFO *pointerInfo
);
Parametri
[in] pointerId
Identificatore del puntatore per il quale recuperare informazioni.
[in, out] entriesCount
Puntatore a una variabile che specifica il conteggio delle strutture nel buffer a cui punta pointerInfo. Se GetPointerInfoHistory ha esito positivo, le vociCount vengono aggiornate con il numero totale di strutture disponibili. Il numero totale di strutture disponibili è lo stesso del campo historyCount della struttura POINTER_INFO restituito da una chiamata a GetPointerInfo.
[out, optional] pointerInfo
Indirizzo di una matrice di strutture POINTER_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 quando vengono generati, alcuni spostamenti potrebbero essere uniti. Quando un'applicazione riceve un messaggio di puntatore coalescable, può usare la funzione GetPointerInfoHistory 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 puntatore recuperato più di recente dal thread chiamante. Una volta recuperato 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 GetPointerInfo .
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 riesce e restituisce solo le informazioni per il puntatore specificato.
Se le informazioni associate al frame del puntatore non sono più disponibili, questa funzione non riesce con l'ultimo errore impostato su ERROR_NO_DATA.
Se il thread chiamante non possiede la finestra (in cui l'input è stato originariamente recapitato o dove il messaggio è stato inoltrato) a cui è stato recapitato il messaggio del puntatore, questa funzione ha esito negativo con l'ultimo errore impostato su ERROR_ACCESS_DENIED.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |