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

Vedi anche

Funzioni

GetPointerFrameInfo

GetPointerFrameInfoHistory

GetPointerInfo