> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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](/pt-BR/build/core-features/common/input/advanced/input-advanced-topics)\
[Visão geral do GameInput](/pt-BR/build/core-features/common/input/overviews/input-overview)\
[GameInput](/pt-BR/reference/input/gameinput/gameinput_members)

## Histórico de versões

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

## Documentação conceitual

* [Fundamentos do GameInput](/pt-BR/build/core-features/common/input/overviews/input-fundamentals)


## Related topics

- [GameInputCreate](/reference/input/gameinput/functions/gameinputcreate.md)
- [GameInput](/reference/input/gameinput/gameinput_members.md)
- [GameInput frequently asked questions](/build/core-features/common/input/overviews/input-faq.md)
- [Preguntas más frecuentes sobre GameInput](/es/build/core-features/common/input/overviews/input-faq.md)
- [GameInput 常见问题](/zh-CN/build/core-features/common/input/overviews/input-faq.md)