Skip to main content

XUserGetDefaultAudioEndpointUtf16

Récupère le point de terminaison audio par défaut d’un utilisateur spécifique.

Syntaxe

Paramètres

user   
Type : XUserLocalId
ID local de l’utilisateur dont le point de terminaison audio par défaut doit être obtenu.
defaultAudioEndpointKind   
Type : XUserDefaultAudioEndpointKind
Valeur d’énumération qui indique si le point de terminaison audio par défaut de l’utilisateur effectue le rendu ou la capture de l’audio.
endpointIdUtf16Count   
Type : size_t
Nombre de wchar_t de la mémoire tampon vers laquelle pointe le paramètre endpointIdUtf16. Passez XUserAudioEndpointMaxUtf16Count.
endpointIdUtf16   _Out_writes_to_(endpointIdUtf16Count,endpointIdUtf16Used)
Type : wchar_t

Contient l’ID du point de terminaison audio par défaut de l’utilisateur.
endpointIdUtf16Used   _Out_opt_
Type : size_t*
Contient le nombre réel de wchar_t de l’ID retourné par le paramètre endpointIdUtf16.

Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite ; sinon, retourne un code d’erreur. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.

Remarques

Il n’est pas sûr d’appeler cette fonction sur un thread à durée critique. Pour plus d’informations, consultez Threads à durée critique.
La fonction XUserGetDefaultAudioEndpointUtf16 prend comme argument une énumération XUserDefaultAudioEndpointKind. La fonction de rappel XUserDefaultAudioEndpointUtf16ChangedCallback est appelée lorsque le point de terminaison audio par défaut d’un utilisateur spécifique change. Pour vous inscrire afin de recevoir un rappel lorsque le point de terminaison audio par défaut change, appelez XUserRegisterForDefaultAudioEndpointUtf16Changed. Pour annuler l’inscription à la réception d’un rappel lorsque le point de terminaison audio par défaut change, appelez XUserUnregisterForDefaultAudioEndpointUtf16Changed. L’exemple suivant montre comment récupérer le point de terminaison audio par défaut d’un utilisateur.

Configuration requise

En-tête : XUser.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX Series

Documentation conceptuelle

Voir aussi

XUser XUserDefaultAudioEndpointUtf16ChangedCallback XUserRegisterForDefaultAudioEndpointUtf16Changed XUserUnregisterForDefaultAudioEndpointUtf16Changed
Last modified on October 6, 2026