GameInputHapticInfo
Décrit les fonctionnalités et les métadonnées haptiques.Syntaxe
Membres
audioEndpointIdType : 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 structureGameInputHapticInfo 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 :
Configuration requise
En-tête : GameInput.h Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesDocumentation conceptuelle
Voir aussi
Vue d’ensemble de GameInputGetHapticInfo
GameInput
Chaînes d’ID de point de terminaison
