Funzione GetPointerPenInfo (winuser.h)

Ottiene le informazioni basate sulla penna per il puntatore specificato (di tipo PT_PEN) associato al messaggio corrente.

Sintassi

BOOL GetPointerPenInfo(
  [in]  UINT32           pointerId,
  [out] POINTER_PEN_INFO *penInfo
);

Parametri

[in] pointerId

Identificatore del puntatore per il quale recuperare informazioni.

[out] penInfo

Indirizzo di una struttura POINTER_PEN_INFO per ricevere le informazioni sul puntatore specifico della penna.

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

GetPointerPenInfo recupera informazioni per un singolo puntatore (di tipo PT_PEN) associato a un messaggio di puntatore.

Usare GetPointerFramePenInfo 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 GetPointerPenInfoHistory 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_PEN, questa funzione ha esito negativo con l'ultimo errore impostato su ERROR_DATATYPE_MISMATCH.

Requisiti

Vedi anche

Funzioni

GetPointerFramePenInfo

GetPointerFramePenInfoHistory

GetPointerPenInfoHistory