Skip to main content

XGameStreamingShowTouchControlsWithStateUpdate

Solicita que todos los dispositivos cliente de streaming conectados actualicen su estado de controles táctiles y muestren un diseño táctil especificado. Todas las actualizaciones de estado se producen antes de que se muestre el nuevo diseño táctil.

Sintaxis

Parámetros

layout   _In_opt_z_
Tipo: char*
Nombre del diseño de controles táctiles que se va a mostrar, o nullptr para mostrar el diseño estándar. operationCount   _In_
Tipo: size_t
Tamaño de la matriz de operaciones que se pasa operations   _In_reads_opt_(operationCount)
Tipo: XGameStreamingTouchControlsStateOperation*
Matriz de todas las actualizaciones de variables de estado que se solicitan

Valor devuelto

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

Posibles errores

Comentarios

Esta API se debe usar cuando el juego necesite mostrar un diseño táctil determinado que también requiera algunas actualizaciones de estado que puedan afectar a su representación. Use esta API si desea tanto actualizar el estado de las variables a las que se hace referencia en un nuevo diseño táctil COMO cambiar a ese diseño táctil en todos los dispositivos cliente de streaming conectados. Esta API garantiza que todas las actualizaciones de estado se realicen antes de que se muestre el nuevo diseño. Si desea afectar solo a un cliente específico, use XGameStreamingShowTouchControlsWithStateUpdateOnClient. Si el juego solo quiere cambiar el diseño, debe usar XGameStreamingShowTouchControlLayout en su lugar. Si las actualizaciones de estado pueden afectar al diseño actual o a otros diseños, y las actualizaciones deben producirse independientemente de un cambio de diseño táctil específico, el juego debe usar XGameStreamingUpdateTouchControlsState en su lugar.

Ejemplos

Requisitos

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

Consulte también

XGameStreaming
XGameStreamingTouchControlsStateOperationKind
XGameStreamingTouchControlsStateOperation
XGameStreamingTouchControlsStateValue
XGameStreamingShowTouchControlsWithStateUpdateOnClient
XGameStreamingUpdateTouchControlsState
XGameStreamingUpdateTouchControlsStateOnClient
Última modificación el 28 de agosto de 2026