> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XtfCaptureRecordedGameClip

> XtfCaptureRecordedGameClip

# XtfCaptureRecordedGameClip

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

<a id="syntaxSection" />

## 語法

```cpp theme={null}
HRESULT XtfCaptureRecordedGameClip(
         PCWSTR address,
         PCWSTR fullFileName,
         UINT32 numSeconds
)  
```

<a id="parametersSection" />

### 參數

*address*\
類型: PCWSTR

\[in] 主機的 IP 位址。

*fullFileName*\
類型: PCWSTR

\[in] 要寫入影片之檔案的完整路徑和檔案名稱。

*numSeconds*\
類型: UINT32

\[in] 要擷取的影片秒數。最小值為 6 秒。最大值為 300 秒。

<a id="retvalSection" />

### 傳回值

類型: HRESULT

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

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

<a id="remarksSection" />

## 備註

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

<a id="requirements" />

## 需求

**標頭:** xtfapi.h

**程式庫:** XtfApi.lib

**支援的平台:** Windows (適用於 XBOX 主機工具)

<a id="seealsoSection" />

## 另請參閱

[XtfCaptureScreenshot](/zh-TW/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot)\
[XTF 傳輸錯誤 (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors)\
[其他 Xtf API](/zh-TW/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XAppCaptureRecordClipResult](/zh-TW/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)
- [XAppCaptureRecordDiagnosticClip](/zh-TW/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip.md)
- [XAppCaptureVideoEncoding](/zh-TW/reference/system/xappcapture/enums/xappcapturevideoencoding.md)
- [XtfCaptureScreenshot](/zh-TW/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot.md)
- [DirectCapture 概觀](/zh-TW/build/core-features/common/game-streaming/game-streaming-directcapture-overview.md)