> ## 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.

# IGameInput::RegisterGuideButtonCallback

> IGameInput::RegisterGuideButtonCallback

# IGameInput::RegisterGuideButtonCallback

<Warning>**Preterido.** Este método foi removido no GameInput v1 e não está disponível na API atual. Em vez disso, use [RegisterSystemButtonCallback](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback).</Warning>

Registra uma função de retorno de chamada a ser chamada quando o botão Guia é pressionado ou liberado.

## Sintaxe

```cpp theme={null}
HRESULT RegisterGuideButtonCallback(
    IGameInputDevice* device,
    void* context,
    GameInputGuidButtonCallback* callbackFunc,
    GameInputCallbackToken* callbackToken
);
```

### Parâmetros

*device*   \_In\_opt\_\
Tipo: IGameInputDevice\*

Limita o retorno de chamada registrado a um dispositivo específico.

*context*   \_In\_opt\_\
Tipo: void\*

Contexto definido pelo título passado para a função de retorno de chamada.

*callbackFunc*   \_In\_\
Tipo: [GameInputGuidButtonCallback](/pt-BR/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback)\*

A função de retorno de chamada definida pelo título a ser registrada.

*callbackToken*   \_Result\_zeroonfailure\_\
Tipo: GameInputCallbackToken\*

Token que identifica o retorno de chamada registrado.

### Valor retornado

Tipo: HRESULT

Resultado da função.

## Comentários

Este método foi substituído por [RegisterSystemButtonCallback](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback), que trata eventos dos botões Guia e Compartilhar por meio do tipo de retorno de chamada [GameInputSystemButtonCallback](/pt-BR/reference/input/gameinput/functions/gameinputsystembuttoncallback).

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v1** | Removido. Substituído por [RegisterSystemButtonCallback](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback). |
| **v0** | Introduzido. |

## Confira também

[Membros preteridos da API GameInput](/pt-BR/reference/input/gameinput/deprecated/gameinput_deprecated_members)\
[IGameInput::RegisterSystemButtonCallback](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback)\
[GameInputGuidButtonCallback](/pt-BR/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback)\
[IGameInput](/pt-BR/reference/input/gameinput/interfaces/igameinput/igameinput)


## Related topics

- [IGameInput::RegisterGuideButtonCallback](/ja-jp/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)
- [GameInputGuidButtonCallback](/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)