Skip to main content

​
XAppCaptureMetadataAddDoubleEvent

將具有 double 值的中繼資料事件新增至您的應用程式擷取。

​
語法

​
參數

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 主機

​
概念文件

​
另請參閱

GameDVR 概觀
XAppCapture 成員
XAppCaptureMetadataAddInt32Event
XAppCaptureMetadataAddStringEvent
Last modified on October 6, 2026