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 |