> ## 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::SetFocusPolicy（已弃用）

> 设置游戏输入设备的焦点策略（已在 v4 中移除）。

> [!WARNING]
>
> **已弃用。** 此方法已在 GameInput v4 中移除，当前 API 中不再提供。请改用 [IGameInput::EnableBackgroundInput](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_enablebackgroundinput.md)。

设置游戏输入设备的焦点策略。

## 语法

```cpp theme={null}
void SetFocusPolicy(
    GameInputFocusPolicy policy
);
```

### 参数

*policy*   \_In\_\
类型：[GameInputFocusPolicy](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md)

要设置的焦点策略。

### 返回值

类型：void

无返回值。

## 备注

`IGameInput::SetFocusPolicy` 方法设置游戏输入设备的焦点策略。焦点策略决定输入设备是否根据游戏的焦点状态提供输入。焦点是指游戏是被选为主焦点，还是在其他应用程序拥有焦点时正在后台运行。有关 GameInput API 的中级和高级用例，请参阅 [GameInput 高级主题](https://docs.xbox.com/zh-CN/build/core-features/common/input/advanced/input-advanced-topics.md)。

焦点策略仅适用于 Windows。

在 PC 上，当 GameInput 运行时随应用程序旁加载而不是安装在系统上时，仅接受 `GameInputDefaultFocusPolicy` 和 `GameInputEnableBackgroundInput`。其他值（包括任何标志组合）都会被忽略。有关详细信息，请参阅 [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)\
[IGameInput::EnableBackgroundInput](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_enablebackgroundinput.md)\
[GameInput 概述](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-overview.md)\
[GameInputFocusPolicy](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md)\
[IGameInput](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/igameinput.md)

## 版本历史

| 版本 | 变更 |
| - | - |
| **v4** | 已移除。 |
| **v0** | 引入。 |


## Related topics

- [IGameInput::EnableBackgroundInput](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_enablebackgroundinput.md)
- [GameInputFocusPolicy（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md)
- [IGameInput::SetFocusPolicy](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [IGameInputDevice::SetInputSynchronizationState（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_setinputsynchronizationstate.md)
- [IGameInputDevice::SetRawDeviceFeature（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_setrawdevicefeature.md)