Skip to main content

XGameStreamingShowTouchControlsWithStateUpdate

接続されているすべてのストリーミング クライアント デバイスに対して、タッチ コントロールの状態を更新し、指定されたタッチ レイアウトを表示するよう要求します。すべての状態の更新は、新しいタッチ レイアウトが表示される前に行われます。

Syntax

Parameters

layout   _In_opt_z_
型: char*
表示するタッチ コントロール レイアウトの名前。または、標準レイアウトを表示する場合は nullptr operationCount   _In_
型: size_t
渡される操作配列のサイズ。 operations   _In_reads_opt_(operationCount)
型: XGameStreamingTouchControlsStateOperation*
要求される状態変数の更新の配列。

Return value

型: HRESULT 成功した場合は S_OK を返します。それ以外の場合はエラー コードを返します。

想定されるエラー

Remarks

この API は、レンダリングに影響する可能性のある一部の状態更新も必要とする特定のタッチ レイアウトをゲームが表示する必要がある場合に使用します。新しいタッチ レイアウトで参照される変数の状態を更新すると同時に、接続されているすべてのストリーミング クライアント デバイスのタッチ レイアウトを切り替えたい場合にこの API を使用します。この API は、すべての状態更新が新しいレイアウトの表示前に確実に行われるようにします。 特定のクライアントにのみ影響を与えたい場合は、XGameStreamingShowTouchControlsWithStateUpdateOnClient を使用してください。 レイアウトの変更のみを行いたい場合は、代わりに XGameStreamingShowTouchControlLayout を使用してください。 状態の更新が現在のレイアウトや他のレイアウトに影響する可能性があり、特定のタッチ レイアウト変更に関係なく更新を行う必要がある場合は、代わりに XGameStreamingUpdateTouchControlsState を使用してください。

Examples

Requirements

ヘッダー: XGameStreaming.h ライブラリ: xgameruntime.lib
サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

See also

XGameStreaming
XGameStreamingTouchControlsStateOperationKind
XGameStreamingTouchControlsStateOperation
XGameStreamingTouchControlsStateValue
XGameStreamingShowTouchControlsWithStateUpdateOnClient
XGameStreamingUpdateTouchControlsState
XGameStreamingUpdateTouchControlsStateOnClient
最終更新日 2026年8月24日