Skip to main content

XUserRegisterForDefaultAudioEndpointUtf16Changed

Registra um retorno de chamada que o aplicativo define e invoca quando o ponto de extremidade de áudio padrão é alterado.

Sintaxe

Parâmetros

queue   _In_opt_
Tipo: XTaskQueueHandle
Um identificador para a fila assíncrona na qual o retorno de chamada de alteração será colocado. context   _In_opt_
Tipo: void*
O contexto que o aplicativo define e passa para o retorno de chamada. callback   _In_
Tipo: XUserDefaultAudioEndpointUtf16ChangedCallback*
O retorno de chamada que o aplicativo define e registra para eventos de alteração do ponto de extremidade de áudio. token   _Out_
Tipo: XTaskQueueRegistrationToken*
Em caso de êxito, recebe um token que identifica o retorno de chamada. Para cancelar o registro do retorno de chamada, passe esse token para a função XUserUnregisterForDefaultAudioEndpointUtf16Changed.

Valor retornado

Tipo: HRESULT Código de êxito ou erro HRESULT.
Para obter uma lista de códigos de erro, confira 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, confira Threads sensíveis ao tempo.
Para cancelar o registro de um retorno de chamada de alteração do ponto de extremidade de áudio padrão registrado anteriormente, chame XUserUnregisterForDefaultAudioEndpointUtf16Changed. Para registrar um retorno de chamada de associação de dispositivo do usuário, chame XUserRegisterForDeviceAssociationChanged. Para cancelar o registro de um retorno de chamada de alteração de associação de dispositivo do usuário registrado anteriormente, chame XUserUnregisterForDeviceAssociationChanged.

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
XUserUnregisterForDefaultAudioEndpointUtf16Changed
Last modified on October 6, 2026