次の方法で共有


XAppCaptureMetadataStartDoubleState

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

構文

HRESULT XAppCaptureMetadataStartDoubleState(  
         const char* name,  
         double value,  
         XAppCaptureMetadataPriority priority  
)  

パラメーター

name _In_z_
型: char*

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

value _In_
型: double

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

priority _In_
型: XAppCaptureMetadataPriority

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

戻り値

型: HRESULT

関数の結果です。

解説

注意

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

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

この関数で使用する double 値は、有限である必要があります。 有限ではない double 値は 0 に変換されて受け付けられます。

注意

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

要件

ヘッダー: XAppCapture.h

ライブラリ: xgameruntime.lib

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

関連項目

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