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

# PIXEndCapture

> PIXEndCapture

# PIXEndCapture

停止以 `PIXBeginCapture` 啟動、以程式設計方式控制的擷取。

## 語法

```cpp theme={null}
HRESULT PIXEndCapture(  
         BOOL discard  
)  
```

### 參數

*discard*   \
類型：BOOL

指出是否應捨棄擷取：

* 如果 *discard* 為 TRUE，則會捨棄擷取的資料，且擷取不會顯示在 PIX 中。
* 如果 *discard* 為 FALSE，則會儲存擷取的資料，且 PIX 會顯示產生的擷取。

*discard* 參數可用來捨棄不符合您所尋找之準則的擷取。例如，您可以使用 `PIXBeginCapture` 和 `PIXEndCapture` 嘗試擷取落在預先定義時間範圍內的函式呼叫。您可能只想顯示落在該範圍內之函式呼叫的擷取。

### 傳回值

類型：HRESULT

指出擷取是否成功完成。成功時會傳回 S\_OK。此作業是非同步的，在擷取完全停止之前會傳回 E\_PENDING。當結果為 E\_PENDING 時，遊戲不應結束或啟動新的擷取。

## 備註

使用 [PIXBeginCapture](/zh-TW/reference/tools/pix3/functions/pixbegincapture) 開始 PIX 擷取。\
如需啟動 PIX 擷取之需求的詳細資訊，請參閱 [PIXBeginCapture](/zh-TW/reference/tools/pix3/functions/pixbegincapture) 的「備註」一節。

下列 C++ 範例示範如何開始和結束 PIX 擷取。

```cpp theme={null}
//
//  timing capture
//
PIXCaptureParameters captureParams = {};

captureParams.TimingCaptureParameters.CaptureGpuTiming = TRUE;
captureParams.TimingCaptureParameters.CaptureCallstacks = TRUE;
captureParams.TimingCaptureParameters.CaptureCpuSamples = TRUE;
captureParams.TimingCaptureParameters.CpuSamplesPerSecond = 4000;

captureParams.TimingCaptureParameters.CaptureStorage = PIXCaptureParameters::Memory;
captureParams.TimingCaptureParameters.FileName = wstrFilename;
captureParams.TimingCaptureParameters.MaximumToolingMemorySizeMb = 4096;

XSF_ERROR_IF_FAILED(PIXBeginCapture(PIX_CAPTURE_TIMING, &captureParams));

while (PIXEndCapture(FALSE) == E_PENDING)
{
    // Keep running
}

```

## 需求

**標頭：** pix3.h

**程式庫：** pixevt.lib

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

## 另請參閱

[PIXBeginCapture](/zh-TW/reference/tools/pix3/functions/pixbegincapture)\
[PIX3](/zh-TW/reference/tools/pix3/pix3_members)\
[PIX (NDA 主題)](/zh-TW/tools/tools-console/pix/pix)


## Related topics

- [PIXEndCapture](/reference/tools/pix3/functions/pixendcapture.md)
- [PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture.md)
- [PIX3](/reference/tools/pix3/pix3_members.md)