Skip to main content

XUserGetDefaultAudioEndpointUtf16

Recupera o ponto de extremidade de áudio padrão de um usuário específico.

Sintaxe

Parâmetros

user   
Tipo: XUserLocalId
A ID local do usuário para o qual obter o ponto de extremidade de áudio padrão.
defaultAudioEndpointKind   
Tipo: XUserDefaultAudioEndpointKind
Um valor de enumeração que especifica se o ponto de extremidade de áudio padrão do usuário renderiza ou captura áudio.
endpointIdUtf16Count   
Tipo: size_t
A contagem de wchar_t do buffer para o qual o parâmetro endpointIdUtf16 aponta. Passe XUserAudioEndpointMaxUtf16Count.
endpointIdUtf16   _Out_writes_to_(endpointIdUtf16Count,endpointIdUtf16Used)
Tipo: wchar_t

Contém a ID do ponto de extremidade de áudio padrão do usuário.
endpointIdUtf16Used   _Out_opt_
Tipo: size_t*
Contém a contagem real de wchar_t da ID que o parâmetro endpointIdUtf16 retorna.

Valor retornado

Tipo: HRESULT Retornará S_OK se for bem-sucedido; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, consulte Códigos de erro.

Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
A função XUserGetDefaultAudioEndpointUtf16 recebe uma enumeração XUserDefaultAudioEndpointKind como argumento. A função de retorno de chamada XUserDefaultAudioEndpointUtf16ChangedCallback é invocada quando o ponto de extremidade de áudio padrão de um usuário específico é alterado. Para se registrar para receber um retorno de chamada quando o ponto de extremidade de áudio padrão for alterado, chame XUserRegisterForDefaultAudioEndpointUtf16Changed. Para cancelar o registro para receber um retorno de chamada quando o ponto de extremidade de áudio padrão for alterado, chame XUserUnregisterForDefaultAudioEndpointUtf16Changed. O exemplo a seguir demonstra como recuperar o ponto de extremidade de áudio padrão de um usuário.

Requisitos

Cabeçalho: XUser.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XUser XUserDefaultAudioEndpointUtf16ChangedCallback XUserRegisterForDefaultAudioEndpointUtf16Changed XUserUnregisterForDefaultAudioEndpointUtf16Changed
Last modified on October 6, 2026