Funzione GetPointerInfo (winuser.h)

Ottiene le informazioni per il puntatore specificato associato al messaggio corrente.

Nota Usare GetPointerType se non sono necessarie le informazioni aggiuntive esposte da GetPointerInfo.

 

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)

Vedi anche

Funzioni

GetPointerFrameInfo

GetPointerFrameInfoHistory

GetPointerInfoHistory