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) 或類似的儲存系統,以在設定的期間內保留剪輯。
