Funzione GetPointerPenInfoHistory (winuser.h)
Ottiene le informazioni basate sulla penna associate ai singoli input, se presenti, che sono state combinate nel messaggio corrente per il puntatore specificato (di tipo PT_PEN). L'input più recente è incluso nella cronologia restituita e corrisponde all'input più recente restituito dalla funzione GetPointerPenInfo .
Sintassi
BOOL GetPointerPenInfoHistory(
[in] UINT32 pointerId,
[in, out] UINT32 *entriesCount,
[out, optional] POINTER_PEN_INFO *penInfo
);
Parametri
[in] pointerId
Identificatore del puntatore per il quale recuperare informazioni.
[in, out] entriesCount
Puntatore a una variabile che specifica il numero di strutture nel buffer a cui penInfo punta. Se GetPointerPenInfoHistory 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 nella struttura POINTER_PEN_INFO restituito da una chiamata a GetPointerPenInfo.
[out, optional] penInfo
Indirizzo di una matrice di strutture POINTER_PEN_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 (di tipo PT_PEN), può usare la funzione GetPointerPenInfoHistory 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 GetPointerPenInfo .
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.
Se il puntatore specificato non è di tipo PT_PEN, questa funzione ha esito negativo con l'ultimo errore impostato su ERROR_DATATYPE_MISMATCH.
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 |