Pular para o conteúdo principal
Preterido. Este método foi removido no GameInput v4 e não está disponível na API atual. Em vez disso, leia o estado dos botões do sistema a partir das leituras de entrada com IGameInputReading::GetSystemButtonState e GameInputKindSystemButton.
Registra uma função de retorno de chamada que é chamada quando o botão Guia ou Compartilhar é pressionado ou liberado.

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 com GAMEINPUT_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 Series

Confira também

Membros preteridos da API GameInput
IGameInputReading::GetSystemButtonState
Tópicos avançados do GameInput
Visão geral do GameInput
IGameInput

Histórico de versões

Última modificação em 6 de novembro de 2026