Skip to main content

XGameStreamingRegisterClientPropertiesChanged

Registra una devolución de llamada que se invocará cuando cambien las propiedades de cualquier dispositivo cliente de streaming.
Tras el registro, la devolución de llamada se invocará con las propiedades de cliente actuales del dispositivo cliente.

Sintaxis

Parámetros

client   _In_
Tipo: XGameStreamingClientId
Identificador del cliente de streaming de juegos para el que se registra a fin de recibir devoluciones de llamada. 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 a un contexto que se pasará a la función de devolución de llamada. callback   _In_
Tipo: XGameStreamingClientPropertiesChangedCallback*
La función de devolución de llamada que se invocará cuando cambien las propiedades del cliente. 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 permite al juego recibir una XGameStreamingClientPropertiesChangedCallback cada vez que cambia una XGameStreamingClientProperty, como las dimensiones físicas de la transmisión. El registro HARÁ que la devolución de llamada se invoque con todas las XGameStreamingClientProperty aplicables, de modo que se puedan consultar los detalles actuales de las propiedades. Cuando el dispositivo cliente de streaming se desconecte, use XGameStreamingUnregisterClientPropertiesChanged para anular el registro de la devolución de llamada.

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

XGameStreamingClientProperty
XGameStreamingClientPropertiesChangedCallback
XGameStreamingUnregisterClientPropertiesChanged
XGameStreaming
Última modificación el 28 de agosto de 2026