> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateForceFeedbackEffect

> CreateForceFeedbackEffect

# CreateForceFeedbackEffect

Usa la interfaz [IGameInputForceFeedbackEffect](/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect) para realizar el seguimiento del efecto de retroalimentación de fuerza que actúa sobre un motor.

## Sintaxis

```cpp theme={null}
HRESULT CreateForceFeedbackEffect(
    uint32_t motorIndex,
    const GameInputForceFeedbackParams* params,
    IGameInputForceFeedbackEffect** effect
);
```

### Parámetros

*motorIndex*   \_In\_\\
Tipo: uint32\_t

Índice del motor afectado por el efecto de retroalimentación de fuerza.

*params*   \_In\_\\
Tipo: [GameInputForceFeedbackParams\*](/reference/input/gameinput/structs/gameinputforcefeedbackparams)

Parámetros que definen la naturaleza del efecto de retroalimentación de fuerza.

*effect*   \_COM\_Outptr\_\\
Tipo: IGameInputForceFeedbackEffect\*\*

La interfaz [IGameInputForceFeedbackEffect](/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect) resultante que realiza el seguimiento de la vida del efecto hasta su resolución.

### Valor devuelto

Tipo: HRESULT

Esta función devuelve un resultado de error si no hay suficientes recursos de hardware para crear el efecto, o si el hardware no admite el efecto solicitado.

## Comentarios

El método `CreateForceFeedbackEffect` usa la interfaz `IGameInputForceFeedbackEffect` para realizar el seguimiento del efecto de retroalimentación de fuerza que actúa sobre un motor. Si el dispositivo del que se realiza el seguimiento se desconecta antes de que finalice el efecto de retroalimentación, el efecto de retroalimentación queda huérfano durante su vigencia y notificará su estado como "stopped" hasta que se liberen los recursos. Para obtener más información, consulte [Información general de GameInput](/build/core-features/common/input/overviews/input-overview).

## Requisitos

**Encabezado:** GameInput.h

[GameInput](/reference/input/gameinput/gameinput_members)\
[IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## Historial de versiones

| Versión | Cambios       |
| ------- | ------------- |
| **v0**  | Se introdujo. |


## Related topics

- [Force feedback en GameInput](/es/build/core-features/common/input/advanced/input-forcefeedback.md)
- [Interfaz de retroalimentación de fuerza de GameInput](/es/build/core-features/common/input/hardware/input-hardware-force-feedback.md)
- [GameInputForceFeedbackEffectKind](/es/reference/input/gameinput/enums/gameinputforcefeedbackeffectkind.md)
- [IGameInputForceFeedbackEffect::SetState](/es/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_setstate.md)
- [IGameInputForceFeedbackEffect::GetGain](/es/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getgain.md)