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

# GetExtraButtonCount

> GetExtraButtonCount

# GetExtraButtonCount

Obtém o número de botões extras, ou botões sem suporte, presentes no dispositivo para um determinado tipo de entrada.

## Sintaxe

```cpp theme={null}
HRESULT GetExtraButtonCount(
    GameInputKind inputKind,
    uint32_t* extraButtonCount
);
```

### Parâmetros

*inputKind*   \_In\_\
Tipo: GameInputKind

O tipo de entrada cuja contagem de botões extras está sendo solicitada.

*extraButtonCount*   \_Out\_\
Tipo: uint32\_t\*

O número de botões extras, ou botões sem suporte, presentes no dispositivo para o tipo de entrada especificado.

### Valor retornado

Tipo: HRESULT

Resultado da função.

## Comentários

Botões extras são botões do controle que existem no dispositivo físico, mas não fazem parte do mapeamento padrão para o tipo de entrada especificado. Este método é útil para aplicativos que desejam acessar botões específicos do dispositivo que vão além do mapeamento de entrada padrão.

A contagem obtida deve ser usada com o método [GetExtraButtonIndexes](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes.md) para recuperar os índices específicos desses botões extras e para reservar em buffer o espaço correto para armazenar os índices de botão fornecidos por esse método.

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

[GameInputKind](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputkind.md)\

[GetExtraButtonIndexes](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes.md)\

[GetExtraAxisCount](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxiscount.md)\

[IGameInputDevice](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v3** | Introduzido. |


## Related topics

- [GetExtraButtonIndexes](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes.md)
- [GetExtraAxisCount](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxiscount.md)
- [IGameInputDevice (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [GetControllerButtonCount](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerbuttoncount.md)
- [GetExtraAxisIndexes](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxisindexes.md)