> ## 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/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md) 报告的 Guide 和 Share 系统按钮。调用 `EnableBackgroundInput(false)` 可恢复默认行为。

此设置主要与 Windows 相关，因为在 Windows 上多个应用程序可以同时运行，焦点可以在它们之间切换。

此方法取代了早期 GameInput 版本中的 [IGameInput::SetFocusPolicy](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md) 方法和 [GameInputFocusPolicy](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md) 枚举。用于阻止其他进程接收输入的独占前台策略在 GameInput v4 中不可用。

在 PC 上，当 GameInput 运行时随应用程序旁加载而不是安装在系统上时，启用后台输入的操作会被忽略。有关详细信息，请参阅 [GameInput 旁加载](https://docs.xbox.com/zh-CN/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/zh-CN/build/core-features/common/input/overviews/input-overview.md)\
[GameInput 基础](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-fundamentals.md)\
[GameInput 旁加载](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-agility-redistributable.md)\
[IGameInput](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/igameinput.md)\
[IGameInput::SetFocusPolicy（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)

## 版本历史

| 版本 | 变更 |
| - | - |
| **v4** | 引入。 |


## Related topics

- [IGameInput::SetFocusPolicy（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [IGameInputReading::GetSystemButtonState](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md)
- [GameInputFocusPolicy（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md)
- [GameInput 旁加载](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-agility-redistributable.md)
- [已弃用的 GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)