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

# GameInputFocusPolicy

> GameInputFocusPolicy

# GameInputFocusPolicy

입력 장치의 포커스 정책을 열거합니다.

## 구문

```cpp theme={null}
enum GameInputFocusPolicy
{
    GameInputDefaultFocusPolicy             = 0x00000000,
    GameInputExclusiveForegroundInput       = 0x00000002,
    GameInputExclusiveForegroundGuideButton = 0x00000008,
    GameInputExclusiveForegroundShareButton = 0x00000020,
    GameInputEnableBackgroundInput          = 0x00000040,
    GameInputEnableBackgroundGuideButton    = 0x00000080,
    GameInputEnableBackgroundShareButton    = 0x00000100
};
```

## 상수

| 상수 | 설명 |
| - | - |
| GameInputDefaultFocusPolicy | 프로세스가 포커스에 있을 때만 입력과 시스템 버튼이 전송되도록 보장합니다. |
| GameInputExclusiveForegroundInput | GameInput을 사용하는 다른 프로세스가 이 프로세스가 수신하는 입력을 볼 수 없도록 합니다. 이 제한은 게임이 포커스에 있을 때만 적용되며 시스템 버튼에는 적용되지 않습니다. |
| GameInputExclusiveForegroundGuideButton | GameInput을 사용하는 다른 프로세스가 이 프로세스가 수신하는 Guide 버튼 누름을 볼 수 없도록 합니다. 이 제한은 게임이 포커스에 있을 때만 적용됩니다. |
| GameInputExclusiveForegroundShareButton | GameInput을 사용하는 다른 프로세스가 이 프로세스가 수신하는 Share 버튼 누름을 볼 수 없도록 합니다. 이 제한은 게임이 포커스에 있을 때만 적용됩니다. |
| GameInputEnableBackgroundInput | 게임이 포커스에 있지 않을 때도 입력이 항상 게임에 전송되도록 보장합니다. 여기에는 시스템 버튼이 포함되지 않으며, 시스템 버튼은 각자의 포커스 정책 플래그를 사용해야 합니다. |
| GameInputEnableBackgroundGuideButton | 게임이 포커스에 있지 않을 때도 Guide 버튼 이벤트가 게임에 전송되도록 보장합니다. 포커스에 있는 프로세스가 독점 액세스 권한을 가진 경우에는 Guide 버튼 누름이 애플리케이션에 전송되지 않습니다. |
| GameInputEnableBackgroundShareButton | 게임이 포커스에 있지 않을 때도 Share 버튼 이벤트가 게임에 전송되도록 보장합니다. 포커스에 있는 프로세스가 독점 액세스 권한을 가진 경우에는 Share 버튼 누름이 애플리케이션에 전송되지 않습니다. |

## 설명

이 열거형은 [IGameInput::SetFocusPolicy](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_setfocuspolicy) 메서드에서 사용됩니다. `SetFocusPolicy`를 호출하여 게임이 포커스에 있지 않을 때 입력이 전송되는지 여부를 지정합니다. 기본적으로 GameInput은 백그라운드 입력을 제공하지 않습니다. 값은 조합할 수 있습니다.

게임이 Guide 또는 Share 버튼을 처리하는 경우, 각각 `GameInputExclusiveForegroundGuideButton` 또는 `GameInputExclusiveForegroundShareButton` 플래그를 설정하면 백그라운드 오버레이 애플리케이션이 이를 함께 처리하지 않도록 하는 데 도움이 됩니다. 예를 들어, 이렇게 하면 원치 않는 오버레이 메뉴나 스크린샷이 버튼을 사용하려는 게임 위에 나타나는 것을 방지할 수 있습니다.

> [!NOTE]
>
> 많은 사용자는 Guide 버튼을 메뉴에 사용하고 Share 버튼을 스크린샷에 사용하는 오버레이 애플리케이션을 사용합니다. 사용자에게 혼동을 주지 않도록 게임이 그 기능을 재정의해야 하는지 신중히 판단하세요.

포커스 정책은 Windows에서만 적용됩니다. GameInputFocusPolicy의 Guide 및 Share 버튼 값은 Windows SDK 10.0.26031 Preview GameInput.h에 추가되었으며 향후 GDK 릴리스에도 추가될 예정입니다.

자세한 내용은 [GameInput 기본 사항](/ko/build/core-features/common/input/overviews/input-fundamentals)을 참조하세요.

## 요구 사항

**헤더:** GameInput.h

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

## 함께 보기

[GameInput 개요](/ko/build/core-features/common/input/overviews/input-overview)\

[GameInput](/ko/reference/input/gameinput/gameinput_members)

## 버전 기록

| 버전 | 변경 사항 |
| - | - |
| **v2** | `DisableBackgroundInput`(0x1) 및 `DisableBackgroundShareButton`(0x10) **제거**. `EnableBackgroundGuideButton`(0x80) 및 `EnableBackgroundShareButton`(0x100) **추가**. |
| **v0** | 도입되었습니다. |

## 부록: 이전 버전

### v0

```cpp theme={null}
enum GameInputFocusPolicy
{
    GameInputDefaultFocusPolicy             = 0x00000000,
    GameInputDisableBackgroundInput         = 0x00000001,
    GameInputExclusiveForegroundInput       = 0x00000002,
    GameInputExclusiveForegroundGuideButton = 0x00000008,
    GameInputDisableBackgroundShareButton   = 0x00000010,
    GameInputExclusiveForegroundShareButton = 0x00000020,
    GameInputEnableBackgroundInput          = 0x00000040,
};
```

v2에서 제거된 DisableBackgroundInput(0x1) 및 DisableBackgroundShareButton(0x10) 플래그에 유의하세요. GameInput 애플리케이션은 기본적으로 백그라운드 입력이 없으므로 이 플래그들은 중복되었습니다. v2에서는 애플리케이션이 백그라운드에서 입력을 수신하겠다는 의도를 등록할 수 있도록 EnableBackgroundGuideButton(0x80) 및 EnableBackgroundShareButton(0x100) 플래그가 추가되었습니다.


## Related topics

- [IGameInput::SetFocusPolicy](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [RegisterSystemButtonCallback](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)
- [GameInput API 멤버](/ko/reference/input/gameinput/gameinput_members.md)
- [XInput에서 GameInput으로 포팅](/ko/build/core-features/common/input/porting/input-porting-xinput.md)
- [IGameInput (인터페이스 콘텐츠)](/ko/reference/input/gameinput/interfaces/igameinput/igameinput.md)