GetPointerTouchInfo, fonction (winuser.h)
Obtient les informations tactiles pour le pointeur spécifié (de type PT_TOUCH) associé au message actif.
Syntaxe
BOOL GetPointerTouchInfo(
[in] UINT32 pointerId,
[out] POINTER_TOUCH_INFO *touchInfo
);
Paramètres
[in] pointerId
Identificateur du pointeur pour lequel récupérer des informations.
[out] touchInfo
Adresse d’une structure de POINTER_TOUCH_INFO pour recevoir les informations du pointeur tactile.
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étaillées sur l’erreur, appelez GetLastError.
Remarques
GetPointerTouchInfo récupère des informations pour un pointeur unique (de type PT_TOUCH) associé à un message de pointeur.
Utilisez GetPointerFrameTouchInfo pour récupérer des informations de trame associées à un message pour un ensemble de pointeurs.
Les informations retournées par GetPointerTouchInfo sont associées au message de pointeur le plus récent récupéré par le thread appelant. Lorsque le message suivant est récupéré par le thread appelant, les informations associées au message précédent peuvent ne plus être disponibles.
Si l’application ne traite pas les messages d’entrée de pointeur aussi rapidement qu’ils sont générés, certains messages peuvent être fusionnés en un message WM_POINTERUPDATE . Utilisez GetPointerTouchInfoHistory pour récupérer l’historique des messages à partir du message WM_POINTERUPDATE le plus récent.
Si les informations associées au message ne sont plus disponibles, cette fonction échoue avec le dernier paramètre d’erreur défini sur ERROR_NO_DATA.
Si le thread appelant ne possède pas la fenêtre à laquelle le message de pointeur a été remis, cette fonction échoue avec la dernière erreur définie sur ERROR_ACCESS_DENIED. Notez qu’il peut s’agir de la fenêtre vers laquelle l’entrée a été remise à l’origine ou d’une fenêtre vers laquelle le message a été transféré.
Si le pointeur spécifié n’est pas de type PT_TOUCH, cette fonction échoue avec le dernier paramètre d’erreur défini sur ERROR_DATATYPE_MISMATCH.
Configuration requise
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winuser.h (inclure Windows.h) |
| Bibliothèque | User32.lib |
| DLL | User32.dll |