Skip to main content

​
AppCaptureMetadataStartStringState

將具有字串值的中繼資料狀態新增至您的應用程式擷取。

​
語法

​
參數

name   _In_z_
類型：char* 要新增至應用程式擷取時間軸的狀態名稱。 value   _In_z_
類型：char* 要新增至時間軸的狀態值。必須是字串。 priority   _In_
類型：XAppCaptureMetadataPriority 中繼資料的優先順序。用來決定在超過儲存空間限制時要儲存的內容。XAppCaptureMetaDataPriority 列舉的成員。

​
傳回值

類型：HRESULT 函式結果。

​
備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱時間敏感執行緒。
系統會將中繼資料狀態與一段時間範圍建立關聯，該時間範圍從狀態開始時起，直到其值變更或透過呼叫 XAppCaptureMetaDataStopAllStates 停止狀態時為止。此中繼資料用來在直播和擷取的播放期間識別事件，以便分類和搜尋內容。若要儲存適用於某個瞬間時間點的字串值，請使用 XAppCaptureMetadataAddStringEvent。
中繼資料可能會上傳至 XBOX Live 和/或儲存至 .mp4 檔案、螢幕擷取畫面，或在廣播期間使用，因此絕不應在中繼資料中記錄私人使用者資訊。

​
需求

標頭： XAppCapture.h 程式庫： xgameruntime.lib 支援的平台： Windows、XBOX One 系列主機和 XBOX Series 主機

​
概念文件

​
另請參閱

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