Skip to main content

IGameInput::RegisterSystemButtonCallback

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 se você precisar 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 quando o botão Guia ou Sistema é pressionado ou liberado. O despacho dos retornos de chamada depende da GameInputFocusPolicy definida por IGameInput::SetFocusPolicy no seu processo e em outros processos. Consulte 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. Para parar de receber retornos de chamada, consulte os métodos IGameInput::UnregisterCallback e IGameInput::StopCallback. Isso foi adicionado ao GameInput.h da versão prévia do SDK do Windows 10.0.26031 e será adicionado a uma versão futura do GDK. O exemplo de código a seguir demonstra como escutar 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

Tópicos avançados do GameInput
Visão geral do GameInput
IGameInput

Histórico de versões

Last modified on October 6, 2026