Función XInputGetAudioDeviceIds (xinput.h)

Recupera los identificadores de dispositivo de audio de representación de sonido y captura de sonido que están asociados con los auriculares conectados al controlador especificado.

Sintaxis

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 del jugador asociado al dispositivo.

[out, optional] pRenderDeviceId

Cadena de identificador de dispositivo de audio de Windows Core para representar (altavoces).

[in, out, optional] pRenderCount

Tamaño, en caracteres anchos, del búfer de cadena de identificador de dispositivo de representación.

[out, optional] pCaptureDeviceId

Cadena de identificador de dispositivo de audio de Windows Core para la captura (micrófono).

[in, out, optional] pCaptureCount

Tamaño, en caracteres anchos, del búfer de cadena de identificador de dispositivo de captura.

Valor devuelto

Si la función recupera correctamente los identificadores de dispositivo para representar y capturar, el código de retorno se ERROR_SUCCESS.

Si no hay auriculares conectados al controlador, la función también recuperará ERROR_SUCCESS con NULL como los valores de pRenderDeviceId y pCaptureDeviceId.

Si el dispositivo de puerto del controlador no está conectado físicamente, la función devolverá ERROR_DEVICE_NOT_CONNECTED.

Si se produce un error en la función, devolverá un código de error win32 válido.

Observaciones

Los autores de llamadas deben asignar la memoria de los búferes pasados a XInputGetAudioDeviceIds. Las cadenas resultantes pueden tener una longitud arbitraria.

Requisitos de la plataforma

Windows 8 (XInput 1.4)

Requisitos

Plataforma de destino	Windows
Encabezado	xinput.h
Library	Xinput.lib
Archivo DLL	Xinput1_4.dll

Consulte también

CORE Audio API

Funciones XInput

XInputGetDSoundAudioDeviceGuids