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

> Habilita o deshabilita la entrega de entrada a la aplicación mientras está en segundo plano.

Habilita o deshabilita la entrega de entrada a la aplicación mientras está en segundo plano.

## Sintaxis

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

### Parámetros

*enable*   \_In\_\
Tipo: bool

`true` para recibir entrada mientras la aplicación no tiene el foco; `false` para recibir entrada solo mientras la aplicación tiene el foco.

### Valor devuelto

Tipo: void

Este método no devuelve ningún valor.

## Comentarios

De forma predeterminada, GameInput entrega la entrada a una aplicación solo mientras está en primer plano y tiene el foco. Llame a `EnableBackgroundInput(true)` para recibir también la entrada mientras otra aplicación tiene el foco. La entrada en segundo plano se aplica a todos los tipos de entrada a la vez, incluidos los botones del sistema Guía y Compartir que se notifican a través de [IGameInputReading::GetSystemButtonState](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md). Llame a `EnableBackgroundInput(false)` para volver al comportamiento predeterminado.

Esta configuración es relevante principalmente en Windows, donde varias aplicaciones pueden ejecutarse en paralelo y el foco puede moverse entre ellas.

Este método reemplaza el método [IGameInput::SetFocusPolicy](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md) y la enumeración [GameInputFocusPolicy](https://docs.xbox.com/es/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md) de versiones anteriores de GameInput. Las directivas de primer plano exclusivo, que impedían que otros procesos recibieran entrada, no están disponibles en GameInput v4.

En PC, cuando el runtime de GameInput se carga localmente con la aplicación, en lugar de instalarse en el sistema, la habilitación de la entrada en segundo plano se omite. Para obtener más información, consulte [Carga local (sideloading) de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-agility-redistributable.md).

> [!NOTE]
>
> Muchos usuarios ejecutan aplicaciones de superposición que usan el botón Guía para los menús y el botón Compartir para las capturas de pantalla. Considere si su aplicación necesita procesar los botones del sistema mientras está en segundo plano.

## Requisitos

**Encabezado:** GameInput.h

**Biblioteca:** gameinput.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Información general de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-overview.md)\
[Aspectos básicos de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-fundamentals.md)\
[Carga local (sideloading) de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-agility-redistributable.md)\
[IGameInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/igameinput.md)\
[IGameInput::SetFocusPolicy (en desuso)](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)

## Historial de versiones

| Versión | Cambios |
| - | - |
| **v4** | Se introdujo. |


## Related topics

- [IGameInput::SetFocusPolicy (en desuso)](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_setfocuspolicy.md)
- [IGameInputReading::GetSystemButtonState](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsystembuttonstate.md)
- [GameInputFocusPolicy (en desuso)](https://docs.xbox.com/es/reference/input/gameinput/deprecated/enums/gameinputfocuspolicy.md)
- [Carga local (sideloading) de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-agility-redistributable.md)
- [Miembros de la API de GameInput en desuso](https://docs.xbox.com/es/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)