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 membrecontactId 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.
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 SeriesVoir aussi
Vue d’ensemble de GameInputIGameInputReading
IGameInputReading::GetTouchContactCount
IGameInputDevice::GetTouchSurfaceInfo
GameInputTouchContact
GameInputTouchSurfaceInfo
