> ## 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`로 시작된 프로그래밍 방식으로 제어되는 캡처를 중지합니다.

## Syntax

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

### Parameters

*discard*   \
Type: BOOL

캡처를 폐기해야 하는지 여부를 나타냅니다.

* *discard*가 TRUE이면 캡처된 데이터가 폐기되며 캡처가 PIX에 표시되지 않습니다.
* *discard*가 FALSE이면 캡처된 데이터가 저장되며 결과 캡처가 PIX에 표시됩니다.

*discard* 매개 변수는 원하는 기준을 충족하지 않는 캡처를 버리는 데 유용합니다. 예를 들어 `PIXBeginCapture`와 `PIXEndCapture`를 사용하여 미리 정의된 시간 범위 내에 속하는 함수 호출을 캡처할 수 있습니다. 해당 범위 내에 속하는 함수 호출에 대한 캡처만 표시하고 싶을 수 있습니다.

### Return value

Type: HRESULT

캡처가 성공적으로 완료되었는지 여부를 나타냅니다. 성공 시 S\_OK가 반환됩니다. 이 작업은 비동기적이며 캡처가 완전히 중지될 때까지 E\_PENDING을 반환합니다. 결과가 E\_PENDING인 동안에는 타이틀에서 종료하거나 새 캡처를 시작해서는 안 됩니다.

## Remarks

PIX 캡처를 시작하려면 [PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture)를 사용합니다.\
PIX 캡처 시작에 대한 요구 사항에 대한 자세한 내용은 [PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture)의 Remarks 섹션을 참조하세요.

다음 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
}

```

## Requirements

**Header:** pix3.h

**Library:** pixevt.lib

**Supported platforms:** XBOX One 계열 콘솔 및 XBOX Series 콘솔

## See also

[PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture)\
[PIX3](/reference/tools/pix3/pix3_members)\
[PIX (NDA topic)](/tools/tools-console/pix/pix)


## Related topics

- [PIX3](/ko/reference/tools/pix3/pix3_members.md)
- [XtfCaptureOutputEnd](/ko/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputend-xtfapi-xbox-windows-m.md)
- [XtfCaptureOutputBegin](/ko/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md)
- [XUserDefaultAudioEndpointKind](/ko/reference/system/xuser/enums/xuserdefaultaudioendpointkind.md)
- [XAppCaptureVideoCaptureSettings](/ko/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)