Skip to main content

GameInputHapticInfo

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

Syntaxe

Membres

audioEndpointId
Type : wchar_t
L’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 dotées de fonctions haptiques ressemblent beaucoup aux périphériques audio d’usage général, comme les casques d’écoute ou les haut-parleurs d’ordinateur; 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 précis. 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 par l’intermédiaire de WASAPI ou de l’une des nombreuses API audio de plus haut niveau. Une fois le point de terminaison ouvert, vous pouvez simplement 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, comme 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 le retour haptique à des emplacements physiques qui ne correspondent pas bien à la métaphore du système audio ambiophonique. 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 contiennent un mélange de points de terminaison audio et haptiques. À titre d’illustration, 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 pourrait être élargie dans les versions futures 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