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

# IGameInput::EnableBackgroundInput

> 애플리케이션이 백그라운드에 있는 동안 애플리케이션에 대한 입력 전달을 활성화하거나 비활성화합니다.

애플리케이션이 백그라운드에 있는 동안 애플리케이션에 대한 입력 전달을 활성화하거나 비활성화합니다.

## 구문

```cpp theme={null}
void EnableBackgroundInput(
    bool enable
);
```

### 매개변수

*enable*   \_In\_\
형식: bool

애플리케이션에 포커스가 없는 동안에도 입력을 받으려면 `true`, 애플리케이션에 포커스가 있는 동안에만 입력을 받으려면 `false`입니다.

### 반환값

형식: void

이 메서드는 값을 반환하지 않습니다.

## 설명

기본적으로 GameInput은 애플리케이션이 포그라운드에 있고 포커스를 가진 동안에만 애플리케이션에 입력을 전달합니다. 다른 애플리케이션이 포커스를 가진 동안에도 입력을 받으려면 `EnableBackgroundInput(true)`를 호출하세요. 백그라운드 입력은 [IGameInputReading::GetSystemButtonState](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md)를 통해 보고되는 Guide 및 Share 시스템 버튼을 포함하여 모든 입력 종류에 한꺼번에 적용됩니다. 기본 동작으로 돌아가려면 `EnableBackgroundInput(false)`를 호출하세요.

이 설정은 주로 여러 애플리케이션이 나란히 실행되고 포커스가 애플리케이션 간에 이동할 수 있는 Windows에서 관련이 있습니다.

이 메서드는 이전 버전 GameInput의 [IGameInput::SetFocusPolicy](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md) 메서드와 [GameInputFocusPolicy](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md) 열거형을 대체합니다. 다른 프로세스가 입력을 받지 못하도록 하던 독점 포그라운드 정책은 GameInput v4에서 사용할 수 없습니다.

PC에서 GameInput 런타임이 시스템에 설치되지 않고 애플리케이션과 함께 사이드로드된 경우 백그라운드 입력 활성화는 무시됩니다. 자세한 내용은 [GameInput 사이드로딩](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-agility-redistributable.md)을 참조하세요.

> [!NOTE]
>
> 많은 사용자는 Guide 버튼을 메뉴에 사용하고 Share 버튼을 스크린샷에 사용하는 오버레이 애플리케이션을 실행합니다. 애플리케이션이 백그라운드에 있는 동안 시스템 버튼을 처리해야 하는지 신중히 판단하세요.

## 요구 사항

**헤더:** GameInput.h

**라이브러리:** gameinput.lib

**지원되는 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[GameInput 개요](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-overview.md)\
[GameInput 기본 사항](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-fundamentals.md)\
[GameInput 사이드로딩](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-agility-redistributable.md)\
[IGameInput](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/igameinput.md)\
[IGameInput::SetFocusPolicy (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)

## 버전 기록

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


## Related topics

- [IGameInput::SetFocusPolicy (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [IGameInputReading::GetSystemButtonState](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md)
- [GameInputFocusPolicy (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md)
- [사용되지 않는 GameInput API 멤버](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInput 사이드로딩](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-agility-redistributable.md)