Skip to main content

XUserRegisterForDeviceAssociationChanged

Registra um retorno de chamada para eventos de alteração de associação de dispositivo do usuário.

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*
Um retorno de chamada que o aplicativo define e passa de volta para o retorno de chamada. callback   _In_
Tipo: XUserDeviceAssociationChangedCallback*
Um retorno de chamada que o aplicativo define e registra. token   _Out_
Tipo: XTaskQueueRegistrationToken*
Em caso de êxito, contém um token que identifica o retorno de chamada, que você pode usar para cancelar o registro do retorno de chamada.

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.
Chamar XUserDeviceAssociationRegisterForChangeEvent não invalida retornos de chamada registrados anteriormente. Para cancelar o registro de um retorno de chamada de alteração de associação de dispositivo do usuário, chame XUserUnregisterForDeviceAssociationChanged. Para registrar um retorno de chamada que o aplicativo define e invoca quando o ponto de extremidade padrão é alterado, chame XUserRegisterForDefaultAudioEndpointUtf16Changed. Para cancelar o registro de um retorno de chamada de alteração do ponto de extremidade de áudio padrão, chame XUserUnregisterForDefaultAudioEndpointUtf16Changed.

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