Skip to main content

SetRumbleState

Définit les intensités souhaitées des quatre moteurs de vibration du périphérique.

Syntaxe

Paramètres

params   _In_opt_
Type : GameInputRumbleParams*
Structure contenant les intensités souhaitées pour chaque moteur de vibration. L’intensité d’un moteur de vibration est comprise entre 0.0 et 1.0.

Valeur de retour

Type : void

Remarques

La méthode SetRumbleState définit les intensités souhaitées des quatre moteurs de vibration du périphérique. Comme pour les autres types de retour, une application peut l’appeler à tout moment, mais elle ne sera appliquée au périphérique que lorsque l’application a le focus. Pour simplifier au maximum, les applications ne sont pas tenues de vérifier quels moteurs de vibration un périphérique prend en charge et peuvent spécifier une intensité pour les quatre moteurs. Si le périphérique ne dispose pas de l’un des quatre moteurs, l’implémentation de GameInput tente de s’adapter en ajoutant de l’intensité supplémentaire aux autres moteurs, afin que l’utilisateur ressente tout de même un certain retour. Par exemple, les valeurs de vibration des gâchettes sont émulées sur les manettes de jeu à 2 moteurs en ajoutant une petite quantité d’intensité de vibration supplémentaire au moteur de vibration haute fréquence. Sur les périphériques déconnectés ou dépourvus de moteurs de vibration, l’appel de la méthode SetRumbleState n’a aucun effet. Les valeurs d’intensité des moteurs sont comprises dans la plage [0.0, 1.0]. Toute valeur fournie en dehors de cette plage est ramenée à la valeur valide la plus proche.

Configuration requise

En-tête : GameInput.h Vue d’ensemble de GameInput
GameInputRumbleParams
IGameInputDevice

Historique des versions

Last modified on October 6, 2026