Skip to main content

XAppCaptureRecordTimespan

進行 GameDVR 錄製。不會有任何 UI 指出正在進行此類錄製。使用者無法存取此錄製內容。任何時間最多只能進行 2 個此類錄製。一旦已進行 2 個錄製,就必須呼叫 XAppCaptureCloseLocalStream 來關閉並刪除錄製,才能進行另一個錄製。這可用來擷取過去或未來的活動。

語法

參數

startTimestamp _In_opt_
類型:const SYSTEMTIME *
開始錄製的時間戳記。此參數可以是 null,在此情況下,系統會自動將開始時間計算為過去 durationInMilliseconds 的時間點,而錄製內容將包含過去的活動。 durationInMilliseconds _In_
類型:uint64_t
錄製長度 (毫秒)。 result _Out_
類型:XAppCaptureLocalResult *
函式完成時,包含擷取結果。如需如何讀取所產生的錄製內容,請參閱 XAppCaptureReadLocalStream。

傳回值

類型:HRESULT 函式結果。 如果使用者的 GameDVR 設定禁止遊戲進行擷取,此函式將傳回 E_ACCESSDENIED。

備註

有兩種方式可傳入 startTimestamp 參數來錄製過去的活動。 第一種方式是傳入 null。系統會自動計算時間戳記,並錄製從現在往回 durationInMilliseconds 長度的過去活動。
當配置的空間填滿時,將刪除較舊的剪輯,為新剪輯騰出空間。請使用 PLS (Persistent Local Storage)、connected storage (例如 XGameSave 或 XGameSaveFiles) 或類似的儲存系統,以在設定的期間內保留剪輯。
第二種方式是您必須計算所需的開始時間戳記:將 SYSTEMTIME 或 FILETIME 轉換為 ULARGE_INTEGER,執行必要的運算,然後將 ULARGE_INTEGER 轉換回 SYSTEMTIME。
XAppCaptureRecordTimespan 也可以藉由將 startTimestamp 指定為目前的系統時間,來錄製接下來 durationInMilliseconds 毫秒的活動。
請參閱 XAppCaptureLocalResult 和 XAppCaptureReadLocalStream

需求

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

另請參閱

XAppCapture 成員
Last modified on October 6, 2026