次の方法で共有

XAppCaptureMetadataAddDoubleEvent

  • [アーティクル]

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

構文

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

パラメーター

name _In_z_
型: char*

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

value _In_
型: double

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

priority _In_
型: XAppCaptureMetadataPriority

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

戻り値

型: HRESULT

関数の結果です。

解説

注意

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

このメソッドが呼び出されると、システムはメタデータ イベントをタイムスタンプに関連付けます。 このメタデータは、ライブ ストリーミング中のイベント、およびコンテンツの分類と検索のためにキャプチャされた再生を識別するために使用されます。 時間枠に適用する double 値を保存するには、XAppCaptureMetaDataStartDoubleState を使用します。

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

注意

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

要件

ヘッダー: XAppCapture.h

ライブラリ: xgameruntime.lib

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

関連項目

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