GetTouchInputInfo, fonction (winuser.h)
Récupère des informations détaillées sur les entrées tactiles associées à une poignée d’entrée tactile particulière.
Syntaxe
BOOL GetTouchInputInfo(
[in] HTOUCHINPUT hTouchInput,
[in] UINT cInputs,
[out] PTOUCHINPUT pInputs,
[in] int cbSize
);
Paramètres
[in] hTouchInput
Poignée d’entrée tactile reçue dans le LPARAM d’un message tactile. La fonction échoue avec ERROR_INVALID_HANDLE si ce handle n’est pas valide. Notez que le handle n’est pas valide après avoir été utilisé dans un appel réussi à CloseTouchInputHandle ou après avoir été passé à DefWindowProc, PostMessage, SendMessage ou l’une de leurs variantes.
[in] cInputs
Nombre de structures dans le tableau pInputs . Dans l’idéal, cela doit être au moins égal au nombre de points de contact associés au message, comme indiqué dans le message WPARAM. Si cInputs est inférieur au nombre de points tactiles, la fonction réussit toujours et remplit la mémoire tampon pInputs avec des informations sur les points tactiles cInputs .
[out] pInputs
Pointeur vers un tableau de structures TOUCHINPUT pour recevoir des informations sur les points tactiles associés à la poignée d’entrée tactile spécifiée.
[in] cbSize
Taille, en octets, d’une seule structure TOUCHINPUT . Si cbSize n’a pas la taille d’une structure TOUCHINPUT unique, la fonction échoue avec ERROR_INVALID_PARAMETER.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro. Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, utilisez la fonction GetLastError .
Remarques
L’appel de CloseTouchInputHandle ne libère pas la mémoire associée aux valeurs récupérées dans un appel à GetTouchInputInfo. Les valeurs des structures passées à GetTouchInputInfo seront valides jusqu’à ce que vous les supprimiez.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winuser.h (inclure Windows.h) |
| Bibliothèque | User32.lib |
| DLL | User32.dll |
| Ensemble d’API | ext-ms-win-ntuser-misc-l1-2-0 (introduit dans Windows 8.1) |