Skip to main content

XUserGetDefaultAudioEndpointUtf16

Recupera el punto de conexión de audio predeterminado para un usuario específico.

Sintaxis

Parámetros

user   
Tipo: XUserLocalId
El identificador local del usuario para el que se obtiene el punto de conexión de audio predeterminado.
defaultAudioEndpointKind   
Tipo: XUserDefaultAudioEndpointKind
Un valor de enumeración que especifica si el punto de conexión de audio predeterminado del usuario representa o captura audio.
endpointIdUtf16Count   
Tipo: size_t
El recuento de wchar_t del búfer al que apunta el parámetro endpointIdUtf16. Pase XUserAudioEndpointMaxUtf16Count.
endpointIdUtf16   _Out_writes_to_(endpointIdUtf16Count,endpointIdUtf16Used)
Tipo: wchar_t

Contiene el identificador del punto de conexión de audio predeterminado del usuario.
endpointIdUtf16Used   _Out_opt_
Tipo: size_t*
Contiene el recuento real de wchar_t del identificador que devuelve el parámetro endpointIdUtf16.

Valor devuelto

Tipo: HRESULT Devuelve S_OK si se realiza correctamente; de lo contrario, devuelve un código de error. Para obtener una lista de los códigos de error, consulte Códigos de error.

Comentarios

No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
La función XUserGetDefaultAudioEndpointUtf16 toma como argumento una enumeración XUserDefaultAudioEndpointKind. La función de devolución de llamada XUserDefaultAudioEndpointUtf16ChangedCallback se invoca cuando cambia el punto de conexión de audio predeterminado de un usuario específico. Para registrarse y recibir una devolución de llamada cuando cambie el punto de conexión de audio predeterminado, llame a XUserRegisterForDefaultAudioEndpointUtf16Changed. Para anular el registro y dejar de recibir una devolución de llamada cuando cambie el punto de conexión de audio predeterminado, llame a XUserUnregisterForDefaultAudioEndpointUtf16Changed. El ejemplo siguiente muestra cómo recuperar el punto de conexión de audio predeterminado de un usuario.

Requisitos

Encabezado: XUser.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XUser XUserDefaultAudioEndpointUtf16ChangedCallback XUserRegisterForDefaultAudioEndpointUtf16Changed XUserUnregisterForDefaultAudioEndpointUtf16Changed
Última modificación el 28 de agosto de 2026