Skip to main content

GameInputHapticInfo

Décrit les fonctionnalités et les métadonnées haptiques.

Syntaxe

Membres

audioEndpointId
Type : wchar_t
Identificateur du point de terminaison audio haptique WASAPI. locationCount
Type : uint32_t
Nombre d’emplacements haptiques. locations
Type : GUID
Liste des emplacements haptiques.

Remarques

Les manettes compatibles haptiques ressemblent fortement aux périphériques audio à usage général tels que les casques ou les haut-parleurs de bureau ; elles sont pilotées par le système audio de Windows. La structure GameInputHapticInfo permet d’associer un point de terminaison audio haptique à un périphérique GameInput spécifique. La méthode GetHapticInfo peut être utilisée pour interroger ces informations une fois que le périphérique signale qu’il est prêt. audioEndpointId est une chaîne d’identificateur de point de terminaison qui peut être utilisée pour accéder au périphérique haptique via WASAPI, ou via l’une des nombreuses API audio de niveau supérieur. Une fois le point de terminaison ouvert, il vous suffit de diffuser votre forme d’onde haptique vers le périphérique. Les périphériques audio conventionnels disposent d’emplacements bien définis pour les haut-parleurs, tels qu’avant gauche, avant droit et centre. La situation est plus nuancée pour les manettes haptiques, car le périphérique peut prendre en charge un retour haptique à des emplacements physiques qui ne correspondent pas bien à la métaphore du système audio surround. Afin d’adapter les index de canaux audio existants aux emplacements haptiques, un mappage propre au périphérique est fourni. Le nombre d’emplacements haptiques est toujours supérieur à zéro pour les manettes qui prennent en charge l’haptique. La liste des emplacements contient des mappages 1:1 vers les index de canaux audio. Les emplacements répétés ne sont pas autorisés, à l’exception de GAMEINPUT_HAPTIC_LOCATION_NONE, qui peut servir de remplissage pour les points de terminaison qui combinent des points de terminaison audio et haptiques. Pour illustrer ce point, examinons la liste d’emplacements ci-dessous :
Dans cet exemple, les canaux 0 et 1 ne sont pas utilisés, et les canaux 2 et 3 sont mappés respectivement à la poignée gauche et à la poignée droite. La liste des emplacements haptiques pourra être étendue dans les futures versions de GameInput.

Configuration requise

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

Documentation conceptuelle

Voir aussi

Vue d’ensemble de GameInput
GetHapticInfo
GameInput
Chaînes d’ID de point de terminaison

Historique des versions

Last modified on October 6, 2026