Funzione GetTouchInputInfo (winuser.h)

  • Articolo

Recupera informazioni dettagliate sugli input tocco associati a un handle di input tocco specifico.

Sintassi

BOOL GetTouchInputInfo(
  [in]  HTOUCHINPUT hTouchInput,
  [in]  UINT        cInputs,
  [out] PTOUCHINPUT pInputs,
  [in]  int         cbSize
);

Parametri

[in] hTouchInput

Handle di input tocco ricevuto nell'LPARAM di un messaggio di tocco. La funzione ha esito negativo con ERROR_INVALID_HANDLE se questo handle non è valido. Si noti che l'handle non è valido dopo che è stato usato in una chiamata riuscita a CloseTouchInputHandle o dopo che è stato passato a DefWindowProc, PostMessage, SendMessage o una delle relative varianti.

[in] cInputs

Numero di strutture nella matrice pInputs . Questo dovrebbe essere almeno uguale al numero di punti di tocco associati al messaggio, come indicato nel messaggio WPARAM. Se cInputs è minore del numero di punti tocco, la funzione avrà comunque esito positivo e popola il buffer pInputs con informazioni sui punti tocco cInputs .

[out] pInputs

Puntatore a una matrice di strutture TOUCHINPUT per ricevere informazioni sui punti di tocco associati all'handle di input tocco specificato.

[in] cbSize

Dimensione, in byte, di una singola struttura TOUCHINPUT . Se cbSize non è la dimensione di una singola struttura TOUCHINPUT , la funzione ha esito negativo con ERROR_INVALID_PARAMETER.

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 ottenere informazioni sull'errore estese, usare la funzione GetLastError .

Commenti

La chiamata a CloseTouchInputHandle non libera memoria associata ai valori recuperati in una chiamata a GetTouchInputInfo. I valori nelle strutture passate a GetTouchInputInfo saranno validi fino a quando non vengono eliminati.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [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-ntuser-misc-l1-2-0 (introdotto in Windows 8.1)

Vedi anche

CloseTouchInputHandle

Funzioni

TOUCHINPUT