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

# GameInputCreate

> GameInputCreate

# GameInputCreate

IGameInput 인터페이스의 인스턴스를 가져옵니다.

## 구문

```cpp theme={null}
HRESULT GameInputCreate(
    IGameInput** gameInput
);
```

### 매개변수

*gameInput*   \_COM\_Outptr\_\
형식: IGameInput\*\*

호출을 통해 반환되는 프로세스당 싱글톤의 인스턴스입니다.

### 반환값

형식: HRESULT

함수 결과입니다.

## 설명

`GameInputCreate` 함수는 GameInput의 인스턴스를 가져오거나 만들기 위한 Nano-COM 팩터리입니다. 반환되는 인터페이스는 이 함수가 처음 호출될 때 생성되는 프로세스당 싱글톤에 의해 뒷받침됩니다. 따라서 이 함수의 첫 번째 호출은 반환되는 데 짧은 시간이 걸릴 수 있지만, 일반적으로 UI 스레드에서 호출하기에는 충분히 짧고 게임 루프와 같은 시간에 민감한 컨텍스트에서는 호출하지 않는 것이 좋습니다. 동일한 프로세스에서 이 함수를 이후에 호출하면 기본 싱글톤에 대한 참조가 추가되고 빠르게 반환됩니다.

시스템에서 한 번에 하나의 GameInput 버전만 사용할 수 있으므로 지원되는 인터페이스 집합은 설치된 GameInput 버전에 따라 달라질 수 있습니다. GameInput은 이전 버전과 호환되므로 새 기능이 추가되더라도 새 릴리스는 이전 인터페이스를 계속 지원합니다.

애플리케이션은 시작 시 `GameInputCreate` 함수를 한 번 호출하고 애플리케이션이 종료될 준비가 될 때까지 `IGameInput` 개체 참조를 유지해야 합니다. 이는 프로세스 수명 관리(PLM) 일시 중단 이벤트에 응답하는 유니버설 Windows 플랫폼(UWP) 앱의 경우에도 마찬가지입니다. 앱이 다시 시작될 때 `GameInput` 싱글톤을 다시 초기화하는 비용이 애플리케이션에서 적은 양의 메모리를 해제하는 이점보다 일반적으로 더 크기 때문입니다.

## 요구 사항

**헤더:** GameInput.h

[고급 GameInput 항목](/build/core-features/common/input/advanced/input-advanced-topics)\
[GameInput 개요](/build/core-features/common/input/overviews/input-overview)\
[GameInput](/reference/input/gameinput/gameinput_members)

## 버전 기록

| 버전     | 변경 사항    |
| ------ | -------- |
| **v0** | 도입되었습니다. |

## 개념 문서

* [GameInput 기본 사항](/build/core-features/common/input/overviews/input-fundamentals)


## Related topics

- [GameInput 자주 묻는 질문](/ko/build/core-features/common/input/overviews/input-faq.md)
- [GameInput](/ko/reference/input/gameinput/gameinput_members.md)
- [GameInput 개요](/ko/build/core-features/common/input/overviews/input-overview.md)
- [IGameInput::CreateDispatcher](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createdispatcher.md)
- [IGameInput::CreateAggregateDevice](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createaggregatedevice.md)