Skip to main content

XUserGetDefaultAudioEndpointUtf16

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

Syntaxe

Paramètres

user   
Type : XUserLocalId
ID local de l’utilisateur dont il faut obtenir le point de terminaison audio par défaut.
defaultAudioEndpointKind   
Type : XUserDefaultAudioEndpointKind
Valeur d’énumération qui spécifie si le point de terminaison audio par défaut de l’utilisateur effectue le rendu ou la capture 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 que retourne 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écuritaire d’appeler cette fonction sur un thread sensible au temps. Pour plus d’informations, consultez Threads sensibles au temps.
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 donné change. Pour vous inscrire afin de recevoir un rappel lorsque le point de terminaison audio par défaut change, appelez XUserRegisterForDefaultAudioEndpointUtf16Changed. Pour annuler votre 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