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

Interrompe uma captura controlada programaticamente que foi iniciada com `PIXBeginCapture`.

## Sintaxe

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

### Parâmetros

*discard*   \
Tipo: BOOL

Indica se a captura deve ser descartada:

* Se *discard* for TRUE, os dados capturados serão descartados e a captura não será exibida no PIX.
* Se *discard* for FALSE, os dados capturados serão salvos e o PIX exibirá a captura resultante.

O parâmetro *discard* é útil para descartar capturas que não atenderam aos critérios que você procurava. Por exemplo, você pode usar `PIXBeginCapture` e `PIXEndCapture` para tentar capturar chamadas a uma função que se enquadram em um intervalo de tempo predefinido. Talvez você queira exibir apenas as capturas de chamadas a uma função que se enquadram nesse intervalo.

### Valor retornado

Tipo: HRESULT

Indica se a captura foi concluída com êxito. S\_OK é retornado em caso de êxito. A operação é assíncrona e retornará E\_PENDING até que a captura seja totalmente interrompida. O título não deve sair nem iniciar uma nova captura enquanto o resultado for E\_PENDING.

## Comentários

Use [PIXBeginCapture](/pt-BR/reference/tools/pix3/functions/pixbegincapture) para iniciar uma captura do PIX.\
Para obter mais informações sobre os requisitos para iniciar uma captura do PIX, consulte a seção Comentários de [PIXBeginCapture](/pt-BR/reference/tools/pix3/functions/pixbegincapture).

O exemplo em C++ a seguir demonstra como iniciar e encerrar uma captura do 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
}

```

## Requisitos

**Cabeçalho:** pix3.h

**Biblioteca:** pixevt.lib

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[PIXBeginCapture](/pt-BR/reference/tools/pix3/functions/pixbegincapture)\
[PIX3](/pt-BR/reference/tools/pix3/pix3_members)\
[PIX (tópico sob NDA)](/pt-BR/tools/tools-console/pix/pix)


## Related topics

- [PIXBeginCapture](/pt-BR/reference/tools/pix3/functions/pixbegincapture.md)
- [PIX3](/pt-BR/reference/tools/pix3/pix3_members.md)
- [XtfCaptureOutputEnd](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputend-xtfapi-xbox-windows-m.md)
- [XtfCaptureOutputBegin](/pt-BR/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md)
- [XUserDefaultAudioEndpointKind](/pt-BR/reference/system/xuser/enums/xuserdefaultaudioendpointkind.md)