Sintaxe
Parâmetros
device _In_opt_Tipo: IGameInputDevice* Opcionalmente, limita o retorno de chamada registrado para ser disparado para um dispositivo específico. buttonFilter _In_
Tipo: GameInputSystemButtons O conjunto de botões para os quais receber retornos de chamada, combinados com OR lógico. context _In_opt_
Tipo: void* Um objeto que fornece informações relevantes para a função de retorno de chamada. Normalmente, é o objeto chamador. callbackFunc _In_
Tipo: GameInputSystemButtonCallback Função de retorno de chamada definida pelo título que é chamada quando os botões do sistema são pressionados ou liberados. callbackToken _Out_opt_
Tipo: GameInputCallbackToken* Token que identifica a função de retorno de chamada registrada. Esse token é usado para identificar a função registrada caso você precise cancelar ou cancelar o registro da função de retorno de chamada.
Valor retornado
Tipo: HRESULT Resultado da função.Comentários
Este método registra uma chamada de função de retorno de chamada para quando o botão Guia ou Sistema é pressionado ou liberado. Se os retornos de chamada são despachados depende da GameInputFocusPolicy definida por IGameInput::SetFocusPolicy no seu processo e em outros processos. Confira GameInputFocusPolicy para obter detalhes. No XBOX, o shell sempre consome o botão Guia, portanto esses retornos de chamada nunca são despachados no XBOX. No PC, quando o runtime do GameInput é distribuído via sideload com o aplicativo em vez de instalado no sistema, este método falha comGAMEINPUT_E_FEATURE_REQUIRES_INSTALL (0x838AD02B). Para obter mais informações, confira Sideload do GameInput.
Para parar de receber retornos de chamada, confira os métodos IGameInput::UnregisterCallback e IGameInput::StopCallback.
Isso foi adicionado ao GameInput.h do Windows SDK 10.0.26031 Preview e será adicionado a uma versão futura do GDK.
O exemplo de código a seguir demonstra como escutar os pressionamentos do botão Guia.
Requisitos
Cabeçalho: GameInput.h Biblioteca: gameinput.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesConfira também
Membros preteridos da API GameInputIGameInputReading::GetSystemButtonState
Tópicos avançados do GameInput
Visão geral do GameInput
IGameInput
