Passer au contenu principal
Récupère les contacts sur une surface tactile à partir d’une lecture d’entrée.

Syntaxe

Paramètres

surfaceIndex   _In_
Type : uint32_t
Index de la surface tactile. Doit être inférieur à la valeur retournée par IGameInputDevice::GetTouchSurfaceCount. contactArrayCount   _In_
Type : uint32_t
Nombre d’éléments de contactArray. contactArray   _Out_writes_to_opt_(contactArrayCount, return)
Type : GameInputTouchContact*
Tableau qui reçoit les contacts sur la surface tactile. Peut être null.

Valeur de retour

Type : uint32_t Si contactArray est null, retourne le nombre de contacts sur la surface tactile. Sinon, retourne le nombre de contacts écrits dans contactArray, soit la plus petite valeur entre le nombre de contacts et contactArrayCount. Retourne 0 si la lecture ne contient pas de données tactiles ou si surfaceIndex n’est pas un index de surface valide.

Remarques

Chaque élément de contactArray décrit un contact sur la surface, comme un doigt. Les éléments de contactArray dans lesquels aucun contact n’est écrit sont définis sur zéro. Le membre contactId de GameInputTouchContact reste identique tant que le contact demeure sur la surface ; vous pouvez donc l’utiliser pour suivre un contact d’une lecture à l’autre. Pour dimensionner contactArray, appelez IGameInputReading::GetTouchContactCount, ou utilisez le membre maxContactCount de GameInputTouchSurfaceInfo pour allouer un tableau suffisamment grand pour n’importe quelle lecture. Pour interpréter les coordonnées des contacts, appelez IGameInputDevice::GetTouchSurfaceInfo avec le même index de surface. Les lectures qui contiennent des données tactiles incluent GameInputKindTouch dans IGameInputReading::GetInputKind.
La prise en charge tactile dépend du périphérique et de la plateforme.
L’exemple suivant lit les contacts sur chaque surface tactile d’un périphérique.

Configuration requise

En-tête : GameInput.h Bibliothèque : gameinput.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

Vue d’ensemble de GameInput
IGameInputReading
IGameInputReading::GetTouchContactCount
IGameInputDevice::GetTouchSurfaceInfo
GameInputTouchContact
GameInputTouchSurfaceInfo

Historique des versions

Dernière modification le 6 novembre 2026