次の方法で共有


XAppCaptureMetadataStartInt32State

Int32 型の値を持つメタデータ 状態をアプリのキャプチャに追加します。

構文

HRESULT XAppCaptureMetadataStartInt32State(  
         const char* name,  
         int32_t value,  
         XAppCaptureMetadataPriority priority  
)  

パラメーター

name _In_z_
型: char*

アプリのキャプチャ タイムラインに追加される状態の名前。

value _In_
型: int32_t

タイムラインに追加される状態の値。 Int32 でなければなりません。

priority _In_
型: XAppCaptureMetadataPriority

メタデータの優先順位。 ストレージのリミッターを超えた場合に保存するものを決定するために使用されます。 XAppCaptureMetaDataPriority 列挙型のメンバー。

戻り値

型: HRESULT

関数の結果です。

解説

注意

この関数は、時間依存のスレッドで呼び出すのに安全ではありません。 詳細については、「時間依存のスレッド」を参照してください。

メタデータの状態は、状態が開始されてから、値が変更されるまで、または XAppCaptureMetaDataStopAllStates を呼び出して状態が停止されるまでの時間枠に、関連付けられます。 このメタデータは、ライブ ストリーミング中のイベント、およびコンテンツの分類と検索のためにキャプチャされた再生を識別するために使用されます。 瞬時に適用される整数値を格納するには、XAppCaptureMetaDataAddInt32Event を使用します。

注意

メタデータは、Xbox Live にアップロードされたり、.mp4 ファイルやスクリーンショットに保存されたり、配信の間に使用されたりする可能性があるため、メタ データでユーザーの個人情報を記録しないでください。

要件

ヘッダー: XAppCapture.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

ゲーム録画の概要
XAppCapture のメンバー