Skip to main content

XUserRegisterForChangeEvent

Registra um retorno de chamada para um evento de alteração de usuário.

Sintaxe

Parâmetros

queue   _In_opt_
Tipo: XTaskQueueHandle
Um identificador para a fila assíncrona na qual a operação será executada. context   _In_opt_
Tipo: void*
Contexto definido pelo usuário a ser passado para o retorno de chamada. callback   _In_
Tipo: XUserChangeEventCallback*
Retorno de chamada definido pelo usuário a ser registrado. token   _Out_
Tipo: XTaskQueueRegistrationToken*
Contém um token que identifica o retorno de chamada registrado. Use o token 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.
A enumeração XUserChangeEvent especifica um tipo de evento de alteração. XUserChangeEventCallback é um retorno de chamada para um evento de alteração de usuário. Para cancelar o registro de um retorno de chamada de alteração de usuário registrado anteriormente, chame XUserUnregisterForChangeEvent. O exemplo a seguir demonstra como lidar com eventos de alteração de usuário.

Requisitos

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

Documentação conceitual

Confira também

XUser XUserChangeEvent XUserChangeEventCallback XUserUnregisterForChangeEvent
Last modified on October 6, 2026