> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IGameInput::RegisterGuideButtonCallback (Preterido)

> 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](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md).

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](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)\*

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](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md), que trata eventos dos botões Guia e Compartilhar por meio do tipo de retorno de chamada [GameInputSystemButtonCallback](https://docs.xbox.com/pt-BR/reference/input/gameinput/functions/gameinputsystembuttoncallback.md).

## Histórico de versões

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

## Confira também

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


## Related topics

- [GameInputGuidButtonCallback (Preterido)](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)
- [RegisterSystemButtonCallback](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)
- [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [IGameInput::RegisterReadingCallback](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md)
- [IGameInput::RegisterKeyboardLayoutCallback](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback.md)