Skip to main content

​
AppCaptureMetadataStartStringState

文字列値を持つメタデータ ステートをアプリ キャプチャに追加します。

​
構文

​
パラメーター

name   _In_z_
型: char* アプリ キャプチャのタイムラインに追加されるステートの名前です。 value   _In_z_
型: char* タイムラインに追加されるステートの値です。 文字列である必要があります。 priority   _In_
型: XAppCaptureMetadataPriority メタデータの優先度です。 ストレージ制限を超えた場合に何を保存するかを決定するために使用されます。 XAppCaptureMetaDataPriority 列挙型のメンバーです。

​
戻り値

型: HRESULT 関数の結果です。

​
解説

この関数は、時間依存スレッドで呼び出しても安全ではありません。 詳細については、「Time-sensitive threads」を参照してください。
システムは、ステートが開始されてから、その値が変更されるか、XAppCaptureMetaDataStopAllStates の呼び出しによりステートが停止されるまでの時間範囲にメタデータ ステートを関連付けます。 このメタデータは、ライブ ストリームやキャプチャした再生中にイベントを識別し、コンテンツの分類と検索を行うために使用されます。 特定の瞬間に適用される文字列値を保存するには、XAppCaptureMetadataAddStringEvent を使用します。
メタデータは、XBOX Live にアップロードされたり、.mp4 ファイルやスクリーンショットに保存されたり、ブロードキャスト中に使用される可能性があるため、ユーザーのプライベート情報をメタデータに記録しないでください。

​
要件

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

​
概念ドキュメント

​
関連項目

GameDVR の概要
XAppCapture メンバー
最終更新日 2026年8月24日

関連トピック

XAppCaptureMetadataStopStateXAppCaptureMetadataStartDoubleStateXAppCaptureMetadataStartInt32StateXAppCaptureMetadataAddStringEventXAppCaptureMetadataStopAllStates