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

# IGameInputDevice::GetContainerId

> Obtém o ID do contêiner do dispositivo de entrada.

Obtém o ID do contêiner do dispositivo de entrada.

## Sintaxe

```cpp theme={null}
void GetContainerId(
    GUID* containerId
);
```

### Parâmetros

*containerId*   \_Out\_\
Tipo: GUID\*

Recebe o ID do contêiner do dispositivo.

### Valor retornado

Tipo: void

## Comentários

O ID do contêiner é o ID do contêiner Plug and Play (PnP) do dispositivo. Todos os nós de dispositivo que pertencem ao mesmo dispositivo físico compartilham o mesmo ID do contêiner. Por exemplo, um controle que também inclui uma entrada para headset expõe nós de dispositivo separados para o controle e para o dispositivo de áudio, mas ambos relatam o mesmo ID do contêiner. Você pode usar o ID do contêiner para associar um dispositivo GameInput a dispositivos relacionados que você descobre por meio de outras APIs, como pontos de extremidade de áudio.

Se o dispositivo não tiver um ID do contêiner, *containerId* será definido como `GUID_NULL`.

O ID do contêiner não muda durante o tempo de vida do objeto de dispositivo.

No GameInput v3 e anteriores, essas informações estavam disponíveis no membro `containerId` da estrutura [GameInputDeviceInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) retornada por [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md).

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

[Visão geral do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputDevice](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[IGameInputDevice::GetDeviceRootId](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicerootid.md)\
[IGameInputDevice::GetPnpPath](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getpnppath.md)

## Histórico de versões

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


## Related topics

- [IGameInputDevice::GetDeviceRootId](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicerootid.md)
- [IGameInputDevice::GetPnpPath](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getpnppath.md)
- [IGameInputDevice::GetDeviceId](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceid.md)
- [IGameInputDevice::GetVendorId](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getvendorid.md)
- [IGameInputDevice::GetProductId](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getproductid.md)