> ## 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.

# XAppCaptureStopUserRecord

> XAppCaptureStopUserRecord

# XAppCaptureStopUserRecord

停止透過 [XAppCaptureStartUserRecord](/zh-TW/reference/system/xappcapture/functions/xappcapturestartuserrecord) 開始，並由輸入的識別碼指定的進行中使用者錄製。使用者會收到快顯通知，指出錄製內容已儲存，且使用者將可存取該錄製內容。此 API 的 Windows 支援將在未來版本中新增。

## 語法

```cpp theme={null}
HRESULT XAppCaptureStopUserRecord(
    const char* localId,
    XAppCaptureUserRecordingResult* result
)
```

### 參數

*localId* \_In\_\
類型：const char\*

代表要求錄製之使用者的控制代碼。

*result* \_Out\_\
類型：[XAppCaptureUserRecordingResult](/zh-TW/reference/system/xappcapture/structs/xappcaptureuserrecordingresult)\*

函式成功完成時，包含所錄製剪輯的資訊。

### 傳回值

類型：HRESULT

函式結果。如需非 `S_OK` 的傳回值，請參閱 [XAppCapture 錯誤碼](/zh-TW/reference/system/xappcapture/xappcapture_errors)。

## 備註

假設 localIdOfUserRecording 保存了從 [XAppCaptureStartUserRecord](/zh-TW/reference/system/xappcapture/functions/xappcapturestartuserrecord) 傳回的本機識別碼。

<Note>如果在錄製達到其最大時間限制之前未呼叫此 API，錄製將會停止並刪除 (不會儲存)。在超過時間限制後呼叫此 API 來停止錄製，將會傳回錯誤碼。</Note>

```cpp theme={null}
XAppCaptureUserRecordingResult userRecording = { 0 };

if (FAILED_LOG(XAppCaptureStopUserRecord(localIdOfUserRecording, &userRecording)))
{
    return;
}

appLog.AddLog("Recording stopped: Start timestamp: %llu, Duration (ms): %llu, File Size (bytes): %llu, Width: %d, Height: %d, Encoding: %d, Color Format: %d\n",
    userRecording.clipStartTimestamp, userRecording.durationInMilliseconds, userRecording.fileSizeInBytes, userRecording.width, userRecording.height, userRecording.encoding, userRecording.colorFormat);
```

## 需求

**標頭：** XAppCapture.h

**程式庫：** xgameruntime.lib

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XAppCapture 成員](/zh-TW/reference/system/xappcapture/xappcapture_members)


## Related topics

- [XAppCaptureStopUserRecord](/zh-CN/reference/system/xappcapture/functions/xappcapturestopuserrecord.md)
- [XAppCaptureStartUserRecord](/reference/system/xappcapture/functions/xappcapturestartuserrecord.md)
- [XAppCaptureUserRecordingResult](/ko/reference/system/xappcapture/structs/xappcaptureuserrecordingresult.md)
- [XAppCapture](/reference/system/xappcapture/xappcapture_members.md)