> ## 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

[IGameInputForceFeedbackEffect](/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect) 인터페이스를 사용하여 모터에 작용하는 포스 피드백 효과를 추적합니다.

## 구문

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

### 매개변수

*motorIndex*   \_In\_\
형식: uint32\_t

포스 피드백 효과에 의해 영향을 받는 모터의 인덱스입니다.

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

포스 피드백 효과의 특성을 정의하는 매개변수입니다.

*effect*   \_COM\_Outptr\_\
형식: IGameInputForceFeedbackEffect\*\*

효과의 해상도 수명을 추적하는 결과 [IGameInputForceFeedbackEffect](/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/igameinputforcefeedbackeffect) 인터페이스입니다.

### 반환값

형식: HRESULT

이 함수는 효과를 만들기에 하드웨어 리소스가 부족하거나 요청된 효과가 하드웨어에서 지원되지 않는 경우 오류 결과를 반환합니다.

## 설명

`CreateForceFeedbackEffect` 메서드는 `IGameInputForceFeedbackEffect` 인터페이스를 사용하여 모터에 작용하는 포스 피드백 효과를 추적합니다. 추적 중인 장치가 피드백 효과가 끝나기 전에 분리되면, 그 수명 피드백 효과는 고립되며 리소스가 해제될 때까지 상태를 "stopped"로 보고합니다. 자세한 내용은 [GameInput 개요](/build/core-features/common/input/overviews/input-overview)를 참조하세요.

## 요구 사항

**헤더:** GameInput.h

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

## 버전 기록

| 버전     | 변경 사항 |
| ------ | ----- |
| **v0** | 도입됨.  |


## Related topics

- [GameInput 포스 피드백 인터페이스](/ko/build/core-features/common/input/hardware/input-hardware-force-feedback.md)
- [GameInput의 포스 피드백](/ko/build/core-features/common/input/advanced/input-forcefeedback.md)
- [GameInputForceFeedbackEffectKind](/ko/reference/input/gameinput/enums/gameinputforcefeedbackeffectkind.md)
- [IGameInputForceFeedbackEffect::SetState](/ko/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_setstate.md)
- [IGameInputForceFeedbackEffect::GetGain](/ko/reference/input/gameinput/interfaces/igameinputforcefeedbackeffect/methods/igameinputforcefeedbackeffect_getgain.md)