Skip to main content

XAppCaptureMetadataAddDoubleEvent

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

構文

パラメーター

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

戻り値

型: HRESULT 関数の結果です。

解説

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

要件

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

概念ドキュメント

関連項目

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