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

# XInputGetAudioDeviceIds

> XInputGetAudioDeviceIds

# XInputGetAudioDeviceIds

<Note>Essa função ainda não foi implementada.</Note>

Recupera as IDs dos dispositivos de renderização e captura de áudio do headset conectado ao controle especificado.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
DWORD XInputGetAudioDeviceIds( 
         DWORD dwUserIndex,​
         LPWSTR pRenderDeviceId,​
         UINT * pRenderCount,​
         LPWSTR pCaptureDeviceId,​
         UINT * pCaptureCount
)​ 
```

<a id="parametersSection" />

### Parâmetros

*dwUserIndex*   \_In\_\
Tipo: DWORD

Índice do jogador associado ao headset; um valor no intervalo de 0 a `XUSER_MAX_COUNT - 1`.

*pRenderDeviceId*    \_Out\_writes\_opt\_z\_(\*pRenderCount)\
Tipo: LPWSTR

ID do dispositivo de renderização de áudio; ou seja, o dispositivo que reproduz a saída de áudio, como fones de ouvido.

*pRenderCount*     \_Inout\_opt\_\
Tipo: UINT\*

Tamanho, em caracteres largos, do buffer de cadeia de caracteres para a ID do dispositivo de renderização.

*pCaptureDeviceId*    \_Out\_writes\_opt\_z\_(\*pCaptureCount)\
Tipo: LPWSTR

ID do dispositivo de captura de áudio; ou seja, o dispositivo que captura a entrada de áudio, como um microfone.

*pCaptureCount*    \_Inout\_opt\_\
Tipo: UINT\*

Tamanho, em caracteres largos, do buffer de cadeia de caracteres para a ID do dispositivo de captura.

<a id="retvalSection" />

### Valor retornado

Tipo: DWORD

Se a função recuperar com êxito as IDs dos dispositivos de renderização e captura, o código de retorno será `ERROR_SUCCESS`.

Se nenhum headset estiver conectado ao controle, a função também retornará `ERROR_SUCCESS`, com `NULL` como valor de *pRenderDeviceId* e *pCaptureDeviceId*.

Se o dispositivo da porta do controle não estiver conectado fisicamente, a função retornará `ERROR_DEVICE_NOT_CONNECTED`.

Se a função falhar, ela retornará um código de erro Win32.

<a id="remarksSection" />

## Comentários

Os chamadores devem alocar a memória para os buffers passados para essa função. As cadeias de caracteres resultantes podem ter comprimento arbitrário.

Para obter mais informações, consulte [O wrapper XInputOnGameInput](/pt-BR/build/core-features/common/input/porting/input-porting-xinput#xinputWrapperSection).

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** XInputOnGameInput.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

<a id="seealsoSection" />

## Confira também

[Portabilidade do XInput para o GameInput](/pt-BR/build/core-features/common/input/porting/input-porting-xinput)\
[XInputOnGameInput](/pt-BR/reference/input/xinputongameinput/xinputongameinput_members)


## Related topics

- [XInputGetAudioDeviceIds](/reference/input/xinputongameinput/functions/xinputgetaudiodeviceids.md)
- [XInputOnGameInput](/reference/input/xinputongameinput/xinputongameinput_members.md)