Funzione GetPointerInfo (winuser.h)
Ottiene le informazioni per il puntatore specificato associato al messaggio corrente.
Sintassi
BOOL GetPointerInfo(
[in] UINT32 pointerId,
[out] POINTER_INFO *pointerInfo
);
Parametri
[in] pointerId
Identificatore del puntatore.
[out] pointerInfo
Indirizzo di una struttura POINTER_INFO che riceve le informazioni sul puntatore.
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
GetPointerInfo recupera informazioni per un singolo puntatore associato a un messaggio di puntatore.
Usare GetPointerFrameInfo per recuperare le informazioni sui frame associate a un messaggio per un set di puntatori.
Le informazioni restituite da GetPointerInfo 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 GetPointerInfoHistory 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.
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 |
| Set di API | ext-ms-win-rtcore-ntuser-wmpointer-l1-1-0 (introdotta in Windows 10, versione 10.0.14393) |