Skip to main content

XGameStreamingRegisterConnectionStateChanged

Registra una devolución de llamada que se invocará cuando cambie el estado de conexión de un dispositivo cliente de streaming. Tras el registro, la devolución de llamada se invocará para todos los dispositivos cliente de streaming que ya estén conectados.

Sintaxis

Parámetros

queue   _In_opt_
Tipo: XTaskQueueHandle
Identificador de la cola asincrónica en la que se colocará la devolución de llamada de cambio. context   _In_opt_
Tipo: void*
Un puntero opcional al contexto que se pasa a la función de devolución de llamada. callback   _In_
Tipo: XGameStreamingConnectionStateChangedCallback*
La función de devolución de llamada que se invocará cuando cambie el estado de conexión de cualquier dispositivo cliente de streaming. token   _Out_
Tipo: XTaskQueueRegistrationToken*
Un puntero al token de registro que se puede usar para anular el registro del evento.

Valor devuelto

Tipo: HRESULT Devuelve S_OK si se realiza correctamente; de lo contrario, devuelve un código de error.

Posibles errores

Para obtener una lista de códigos de error, consulte Códigos de error.

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.
Esta API es la manera recomendada de que el juego realice personalizaciones por dispositivo cliente de streaming y mantenga un estado que permita al juego optimizar la experiencia en función de si hay dispositivos conectados.
Tras el registro, la devolución de llamada se invocará para todos los dispositivos cliente de streaming que estén conectados actualmente.

Ejemplo

Requisitos

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

Documentación conceptual

Consulte también

XGameStreamingConnectionState
XGameStreamingConnectionStateChangedCallback
XGameStreamingUnregisterConnectionStateChanged
XGameStreaming
Última modificación el 28 de agosto de 2026