GameInputForceFeedbackMotorInfo

Defines the force-feedback motor information.

Syntax

struct GameInputForceFeedbackMotorInfo
{
    GameInputFeedbackAxes supportedAxes;
    bool                  isConstantEffectSupported;
    bool                  isRampEffectSupported;
    bool                  isSineWaveEffectSupported;
    bool                  isSquareWaveEffectSupported;
    bool                  isTriangleWaveEffectSupported;
    bool                  isSawtoothUpWaveEffectSupported;
    bool                  isSawtoothDownWaveEffectSupported;
    bool                  isSpringEffectSupported;
    bool                  isFrictionEffectSupported;
    bool                  isDamperEffectSupported;
    bool                  isInertiaEffectSupported;
};

Members

supportedAxes
Type: GameInputFeedbackAxes Supported axes that the force-feedback motor can apply force. isConstantEffectSupported
Type: bool Denotes whether a constant force-feedback effect is supported. isRampEffectSupported
Type: bool Denotes whether a ramp force-feedback effect is supported. isSineWaveEffectSupported
Type: bool Denotes whether a sine wave force-feedback effect is supported. isSquareWaveEffectSupported
Type: bool Denotes whether a square wave force-feedback effect is supported. isTriangleWaveEffectSupported
Type: bool Denotes whether a triangle wave force feedback-effect is supported. isSawtoothUpWaveEffectSupported
Type: bool Denotes whether a sawtooth up wave force-feedback effect is supported. isSawtoothDownWaveEffectSupported
Type: bool Denotes whether a sawtooth down wave force-feedback effect is supported. isSpringEffectSupported
Type: bool Denotes whether a spring force-feedback effect is supported. isFrictionEffectSupported
Type: bool Denotes whether a friction force-feedback effect is supported. isDamperEffectSupported
Type: bool Denotes whether a damper force feedback-effect is supported. isInertiaEffectSupported
Type: bool Denotes whether an inertia force-feedback effect is supported.

Remarks

The GameInputForceFeedbackMotorInfo structure is a member of GameInputDeviceInfo. It defines the information about a force-feedback motor and uses a pointer to the GameInputFeedbackAxes enumeration. On modern devices, force feedback is typically used on racing wheels with one single-axis motor connected to the steering wheel itself. However, the GameInput API supports devices with any number of force-feedback motors and assigns a unique index number to each motor on a device. The “normal” axis is used for special cases where the applied force is dimensionless, such as a pressure suit for a flight simulator.

Requirements

Header: GameInput.h Supported platforms: Windows, XBOX One family consoles and XBOX Series consoles

Conceptual documentation

Force feedback on GameInput

Version History

Version	Changes
v1	Removed `location` (GameInputLocation), `locationId` (uint32_t), and `maxSimultaneousEffects` (uint32_t).
v0	Introduced.

Appendix: Previous versions

v0

struct GameInputForceFeedbackMotorInfo
{
    GameInputFeedbackAxes supportedAxes;
    GameInputLocation     location;
    uint32_t              locationId;
    uint32_t              maxSimultaneousEffects;
    bool                  isConstantEffectSupported;
    bool                  isRampEffectSupported;
    bool                  isSineWaveEffectSupported;
    bool                  isSquareWaveEffectSupported;
    bool                  isTriangleWaveEffectSupported;
    bool                  isSawtoothUpWaveEffectSupported;
    bool                  isSawtoothDownWaveEffectSupported;
    bool                  isSpringEffectSupported;
    bool                  isFrictionEffectSupported;
    bool                  isDamperEffectSupported;
    bool                  isInertiaEffectSupported;
};

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

GameInputForceFeedbackMotorInfo

GameInputForceFeedbackMotorInfo

Syntax

Members

Remarks

Requirements

Conceptual documentation

See also

Version History

Appendix: Previous versions

v0

​GameInputForceFeedbackMotorInfo

​Syntax

​Members

​Remarks

​Requirements

​Conceptual documentation

​See also

​Version History

​Appendix: Previous versions

​v0

GameInputForceFeedbackMotorInfo

Syntax

Members

Remarks

Requirements

Conceptual documentation

See also

Version History

Appendix: Previous versions

v0