Funzione GetPointerTouchInfo (winuser.h)
Ottiene le informazioni basate sul tocco per il puntatore specificato (di tipo PT_TOUCH) associato al messaggio corrente.
Sintassi
BOOL GetPointerTouchInfo(
[in] UINT32 pointerId,
[out] POINTER_TOUCH_INFO *touchInfo
);
Parametri
[in] pointerId
Identificatore del puntatore per il quale recuperare informazioni.
[out] touchInfo
Indirizzo di una struttura POINTER_TOUCH_INFO per ricevere le informazioni sul puntatore specifico del tocco.
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
GetPointerTouchInfo recupera informazioni per un singolo puntatore (di tipo PT_TOUCH) associato a un messaggio di puntatore.
Usare GetPointerFrameTouchInfo per recuperare le informazioni sui frame associate a un messaggio per un set di puntatori.
Le informazioni restituite da GetPointerTouchInfo sono associate al messaggio del puntatore più recente recuperato dal thread chiamante. Quando il messaggio successivo viene recuperato dal thread chiamante, le informazioni associate al messaggio precedente potrebbero non essere più disponibili.
Se l'applicazione non elabora i messaggi di input del puntatore quando vengono generati, alcuni messaggi potrebbero essere uniti in un messaggio di WM_POINTERUPDATE . Usare GetPointerTouchInfoHistory per recuperare la cronologia dei messaggi dal messaggio di WM_POINTERUPDATE più recente.
Se le informazioni associate al messaggio 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 a cui è stato recapitato il messaggio del puntatore, questa funzione non riesce con l'ultimo errore impostato su ERROR_ACCESS_DENIED. Si noti che questa può essere la finestra a cui è stato originariamente recapitato l'input oppure può essere una finestra a cui è stato inoltrato il messaggio.
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 |