Passer au contenu principal
Obtient des informations sur une surface tactile du périphérique d’entrée.

Syntaxe

Paramètres

surfaceIndex
Type : uint32_t
Index de base zéro de la surface tactile. Doit être inférieur à la valeur retournée par IGameInputDevice::GetTouchSurfaceCount. info   _Out_
Type : GameInputTouchSurfaceInfo*
Reçoit des informations sur la surface tactile.

Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite. Retourne E_BOUNDS si surfaceIndex est supérieur ou égal au nombre de surfaces tactiles du périphérique ; dans ce cas, info est mis à zéro.

Remarques

Les informations retournées décrivent le nombre maximal de contacts simultanés que la surface peut signaler, les dimensions de la surface en unités du périphérique et le type de la surface, comme un pavé tactile ou un écran tactile. Les positions de contact signalées par IGameInputReading::GetTouchSurfaceState sont relatives à ces dimensions ; vous pouvez donc les utiliser pour normaliser les positions de contact. Ces informations ne changent pas pendant toute la durée de vie de l’objet périphérique. L’exemple suivant normalise dans la plage [0, 1) la position du premier contact sur chaque surface tactile d’un périphérique.
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 Series

Voir aussi

Vue d’ensemble de GameInput
IGameInputDevice
GameInputTouchSurfaceInfo
IGameInputDevice::GetTouchSurfaceCount
IGameInputReading::GetTouchSurfaceState

Historique des versions

Dernière modification le 6 novembre 2026