GameInputFocusPolicy

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

구문

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 메서드에서 사용됩니다. SetFocusPolicy를 호출하여 게임이 포커스에 있지 않을 때 입력이 전송되는지 여부를 지정합니다. 기본적으로 GameInput은 백그라운드 입력을 제공하지 않습니다. 값은 조합할 수 있습니다. 게임이 Guide 또는 Share 버튼을 처리하는 경우, 각각 GameInputExclusiveForegroundGuideButton 또는 GameInputExclusiveForegroundShareButton 플래그를 설정하면 백그라운드 오버레이 애플리케이션이 이를 함께 처리하지 않도록 하는 데 도움이 됩니다. 예를 들어, 이렇게 하면 원치 않는 오버레이 메뉴나 스크린샷이 버튼을 사용하려는 게임 위에 나타나는 것을 방지할 수 있습니다.

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

포커스 정책은 Windows에서만 적용됩니다. GameInputFocusPolicy의 Guide 및 Share 버튼 값은 Windows SDK 10.0.26031 Preview GameInput.h에 추가되었으며 향후 GDK 릴리스에도 추가될 예정입니다. 자세한 내용은 GameInput 기본 사항을 참조하세요.

요구 사항

헤더: GameInput.h 지원되는 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

함께 보기

GameInput 개요
GameInput

버전 기록

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

부록: 이전 버전

v0

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) 플래그가 추가되었습니다.

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

GameInputFocusPolicy

GameInputFocusPolicy

구문

상수

설명

요구 사항

함께 보기

버전 기록

부록: 이전 버전

v0

​GameInputFocusPolicy

​구문

​상수

​설명

​요구 사항

​함께 보기

​버전 기록

​부록: 이전 버전

​v0

GameInputFocusPolicy

구문

상수

설명

요구 사항

함께 보기

버전 기록

부록: 이전 버전

v0