GameInputCreate
Obtém uma instância da interface IGameInput.Sintaxe
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çãoGameInputCreate é 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 GameInputVisão geral do GameInput
GameInput