XtfCaptureRecordedGameClip

從目前執行中遊戲的 GameDVR 擷取影片短片。

語法

HRESULT XtfCaptureRecordedGameClip(
         PCWSTR address,
         PCWSTR fullFileName,
         UINT32 numSeconds
)  

參數

address
類型: PCWSTR [in] 主機的 IP 位址。 fullFileName
類型: PCWSTR [in] 要寫入影片之檔案的完整路徑和檔案名稱。 numSeconds
類型: UINT32 [in] 要擷取的影片秒數。最小值為 6 秒。最大值為 300 秒。

傳回值

類型: HRESULT 如果成功，會傳回 S_OK；否則會傳回錯誤碼。可能的錯誤碼包括下列各項:

錯誤碼	描述
0x82323001	GameDVR 服務意外關閉。
0x82323002	沒有足夠的儲存空間可儲存另一段短片。
0x82323003	在呼叫 StopRecordAsync 之前，StartRecordAsync 未完成，或並非從此 ApplicationClipCapture 執行個體呼叫。
0x82323004	同時進行的錄製過多。
0x82323005	HTTP 回應文字太大。
0x82323006	缺少先前呼叫 StartRecordingAsync 的相關資訊。
0x82323007	在 StartRecordAsync 之後的分配時間內未呼叫 StopRecordAsync。
0x82323008	非同步呼叫失敗，但未傳回錯誤碼。
0x82323009	嘗試更新雲端識別碼無法使用的雲端短片。
0x8232300A	寫入檔案時發生錯誤。
0x8232300B	找不到任何可錄製的畫面。可能的原因包括: 在指定的時段內，遊戲位於背景。在遊戲啟用後過早要求錄製。
0x8232300C	找不到任何可錄製的畫面。可能的原因包括: 在指定的時段內，遊戲位於背景。在指定的時段內，遊戲並未執行。
0x8232300D	短片中繼資料的格式不正確。
0x8232300E	開始時間太早或太晚。
0x8232300F	錄製持續時間太短或太長。(6 - 300 秒)
0x82323010	使用者或遊戲沒有指定短片的存取權。
0x82323011	沒有可更新的欄位。
0x82323012	在要求的時段內已停用錄製。
0x82323013	在進行另一個錄製時呼叫了 StartRecordAsync。
0x82323014	已呼叫 StopRecordAsync，但未開始任何錄製。
0x82323015	在進行另一個錄製時呼叫了 RecordTimespanAsync。
0x82323016	上傳短片時發生延遲。稍後會再次嘗試上傳。遊戲可以放心忽略此錯誤，或用來通知使用者要求仍在佇列中，但需要更多時間才能完成。
0x82323017	沒有執行中的遊戲，或遊戲沒有適當的認證。
0x82323018	目前的遊戲已封鎖錄製。
0x82323019	短片尚未上傳至雲端。
0x8232301A	為不允許來賓使用者的作業指定了來賓使用者。
0x8232301B	由於正在進行廣播，因此無法使用 GameDVR。
0x8C11040D	遊戲未在目標主機上執行。

備註

遊戲執行時，主機會自動在 FIFO 影片緩衝區中儲存最多 300 秒的影片。XtfCaptureRecordedGameClip 會從緩衝區擷取指定長度的先前儲存影片，並將其儲存在 fullFileName 所指定的檔案中。檔案會以 MP4 影片格式儲存。如需使用 GameDVR 擷取影片短片的詳細資訊，請參閱 GameDVR 和廣播。

需求

標頭: xtfapi.h 程式庫: XtfApi.lib 支援的平台: Windows (適用於 XBOX 主機工具)

另請參閱

XtfCaptureScreenshot
XTF 傳輸錯誤 (NDA 主題)
其他 Xtf API

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XtfCaptureRecordedGameClip

XtfCaptureRecordedGameClip

語法

參數

傳回值

備註

需求

另請參閱

​XtfCaptureRecordedGameClip

​語法

​參數

​傳回值

​備註

​需求

​另請參閱

XtfCaptureRecordedGameClip

語法

參數

傳回值

備註

需求

另請參閱