Função XInputGetDSoundAudioDeviceGuids (xinput.h)
Obtém os GUIDs do dispositivo de renderização de som e de captura de som associados ao headset conectado ao controlador especificado.
Sintaxe
DWORD XInputGetDSoundAudioDeviceGuids(
DWORD dwUserIndex,
GUID *pDSoundRenderGuid,
GUID *pDSoundCaptureGuid
);
Parâmetros
dwUserIndex
[in] Índice do controlador do usuário. Pode ser um valor no intervalo de 0 a 3. Para obter informações sobre como esse valor é determinado e como o valor é mapeado para indicadores no controlador, consulte Vários controladores.
pDSoundRenderGuid
[out] Ponteiro que recebe o GUID do dispositivo de renderização de som do headset.
pDSoundCaptureGuid
[out] Ponteiro que recebe o GUID do dispositivo de captura de som do headset.
Retornar valor
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 GUID_NULL como os valores de pDSoundRenderGuid e pDSoundCaptureGuid.
Se o dispositivo de porta do controlador 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 válido.
Comentários
O uso do DirectSound herdado não é recomendado e o DirectSound não está disponível para aplicativos da Windows Store.
Requisitos de plataforma
SDK do DirectX (XInput 1.3), Windows Vista (XInput 9.1.0)Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | xinput.h |
| Biblioteca | Xinput.lib; Xinput9_1_0.lib |
| DLL | Xinput9_1_0.dll |