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

# 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](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes) 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](/pt-BR/reference/input/gameinput/enums/gameinputkind)<br />
[GetExtraButtonIndexes](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes)<br />
[GetExtraAxisCount](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxiscount)<br />
[IGameInputDevice](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## Histórico de versões

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


## Related topics

- [GetExtraButtonIndexes](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes.md)
- [GetExtraAxisCount](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxiscount.md)
- [IGameInputDevice](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [IGameInputReading::GetControllerButtonCount](/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerbuttoncount.md)
- [GetExtraAxisIndexes](/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxisindexes.md)