Skip to main content

XUserUnregisterForChangeEvent

Anula el registro de una devolución de llamada de cambio de usuario registrada anteriormente.

Sintaxis

Parámetros

token   _In_
Tipo: XTaskQueueRegistrationToken
Un token que devuelve XUserRegisterForChangeEvent y que identifica la devolución de llamada cuyo registro se anulará. wait   _In_
Tipo: bool
Indica si se debe bloquear hasta que se completen las devoluciones de llamada pendientes.

Valor devuelto

Tipo: bool Devuelve false si wait es false y la anulación del registro está pendiente. De lo contrario, devuelve true.

Comentarios

No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
Anulación del registro de una notificación: La anulación del registro quita la devolución de llamada del token del conjunto de devoluciones de llamada registradas.
  • Si no se están ejecutando devoluciones de llamada para el token de devolución de llamada, la llamada devuelve true.
  • Si se están ejecutando devoluciones de llamada y wait es true, la llamada se bloquea hasta que la devolución de llamada en ejecución se complete.
  • Si se están ejecutando devoluciones de llamada y wait es false, la llamada no se bloquea, pero devuelve false. Una vez que la devolución de llamada del token se completa, el registro del token se anula automáticamente.
Este mecanismo permite los siguientes patrones de codificación:
  1. Puede bloquear la anulación del registro para asegurarse de que las devoluciones de llamada nunca se invoquen después de una llamada de anulación del registro.
  2. Puede optar por no bloquear. Si necesita asegurarse de que las devoluciones de llamada se completen antes de eliminar datos, puede llamar periódicamente a la anulación del registro con false para wait. Cuando finalmente devuelva true, todas las devoluciones de llamada habrán terminado y podrá eliminar el estado.
  3. Si una llamada de anulación del registro no invoca la devolución de llamada, puede simplemente pasar false para wait e ignorar el valor devuelto.
Para registrar una devolución de llamada de cambio de usuario, llame a XUserRegisterForChangeEvent. La enumeración XUserChangeEvent especifica un tipo de evento de cambio. XUserChangeEventCallback es una devolución de llamada para un evento de cambio de usuario. En el ejemplo siguiente se muestra cómo controlar los eventos de cambio de usuario.

Requisitos

Encabezado: XUser.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, Steam Deck, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XUser XUserRegisterForChangeEvent XUserChangeEvent XUserChangeEventCallback
Última modificación el 28 de agosto de 2026