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.

ObservaçãoXInputGetDSoundAudioDeviceGuids foi preterido porque não é compatível com Windows 8 (XInput 1.4).

 

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

Confira também

Funções XInput

XInputGetState