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

# GameInputCreate

> GameInputCreate

# GameInputCreate

Obtém uma instância da interface IGameInput.

## Sintaxe

```cpp theme={null}
HRESULT GameInputCreate(
    IGameInput** gameInput
);
```

### Parâmetros

*gameInput*   \_COM\_Outptr\_\
Tipo: IGameInput\*\*

Uma instância do singleton subjacente por processo retornada pela chamada.

### Valor retornado

Tipo: HRESULT

Resultado da função.

## Comentários

A função `GameInputCreate` é uma fábrica Nano-COM para obter ou criar instâncias do GameInput. A interface resultante é apoiada por um singleton por processo criado na primeira vez em que essa função é chamada. Portanto, a primeira chamada a essa função pode levar um pouco de tempo para retornar, tempo curto o suficiente para que geralmente seja seguro chamá-la de um thread de interface do usuário, mas não de contextos sensíveis ao tempo, como um loop de jogo. As chamadas subsequentes a essa função a partir do mesmo processo apenas adicionam outra referência ao singleton subjacente e retornam rapidamente.

Como apenas uma versão do GameInput está disponível no sistema por vez, o conjunto de interfaces com suporte pode variar dependendo da versão do GameInput instalada. Como o GameInput é compatível com versões anteriores, as novas versões continuarão a oferecer suporte às interfaces antigas, mesmo à medida que novos recursos forem adicionados.

Os aplicativos devem chamar a função `GameInputCreate` uma vez durante a inicialização e manter a referência ao objeto `IGameInput` até que o aplicativo esteja pronto para ser encerrado. Isso vale até mesmo para aplicativos da Plataforma Universal do Windows (UWP) que respondem a eventos de suspensão do gerenciamento do tempo de vida do processo (PLM), porque o custo de reinicializar o singleton `GameInput` (quando o aplicativo é retomado) normalmente supera os benefícios de liberar uma pequena quantidade de memória no aplicativo.

## Requisitos

**Cabeçalho:** GameInput.h

[Tópicos avançados do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/advanced/input-advanced-topics.md)\
[Visão geral do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-overview.md)\
[GameInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/gameinput_members.md)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v0** | Introduzida. |

## Documentação conceitual

* [Fundamentos do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-fundamentals.md)


## Related topics

- [Perguntas frequentes sobre o GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-faq.md)
- [Membros da API do GameInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/gameinput_members.md)
- [Fundamentos do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-fundamentals.md)
- [Introdução ao GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-overview.md)
- [IGameInput::CreateDispatcher](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createdispatcher.md)