Compartilhar via


Função XInputGetAudioDeviceIds (xinput.h)

Recupera as IDs do dispositivo de áudio de captura de som e de renderização de som associadas ao headset conectado ao controlador especificado.

Sintaxe

DWORD XInputGetAudioDeviceIds(
  [in]                DWORD  dwUserIndex,
  [out, optional]     LPWSTR pRenderDeviceId,
  [in, out, optional] UINT   *pRenderCount,
  [out, optional]     LPWSTR pCaptureDeviceId,
  [in, out, optional] UINT   *pCaptureCount
);

Parâmetros

[in] dwUserIndex

Índice do jogador associado ao dispositivo.

[out, optional] pRenderDeviceId

Cadeia de caracteres de ID do dispositivo Windows Core Audio para renderização (alto-falantes).

[in, out, optional] pRenderCount

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

[out, optional] pCaptureDeviceId

Cadeia de caracteres de ID do dispositivo windows core audio para captura (microfone).

[in, out, optional] pCaptureCount

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

Valor retornado

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

Se não houver nenhum headset conectado ao controlador, a função também recuperará ERROR_SUCCESS com NULL como os valores de pRenderDeviceId e pCaptureDeviceId.

Se o dispositivo de porta do controlador não estiver fisicamente conectado, a função retornará ERROR_DEVICE_NOT_CONNECTED.

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

Comentários

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

Requisitos de plataforma

Windows 8 (XInput 1.4)

Requisitos

   
Plataforma de Destino Windows
Cabeçalho xinput.h
Biblioteca Xinput.lib
DLL Xinput1_4.dll

Confira também

APIs de áudio principais

Funções XInput

XInputGetDSoundAudioDeviceGuids