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

Syntaxe

Paramètres

surfaceIndex
Type : uint32_t
L’index de base zéro de la surface tactile. Il doit être inférieur à la valeur retournée par IGameInputDevice::GetTouchSurfaceCount. info   _Out_
Type : GameInputTouchSurfaceInfo*
Reçoit des renseignements 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 renseignements retournés 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 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. Les renseignements ne changent pas pendant toute la durée de vie de l’objet périphérique. L’exemple suivant normalise la position du premier contact sur chaque surface tactile d’un périphérique dans la plage [0, 1).
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