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

Detiene una captura controlada mediante programación que se inició con `PIXBeginCapture`.

## Sintaxis

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

### Parámetros

*discard*   \
Tipo: BOOL

Indica si la captura debe descartarse:

* Si *discard* es TRUE, los datos capturados se descartan y la captura no se mostrará en PIX.
* Si *discard* es FALSE, los datos capturados se guardan y PIX mostrará la captura resultante.

El parámetro *discard* es útil para desechar capturas que no cumplían los criterios que buscaba. Por ejemplo, puede usar `PIXBeginCapture` y `PIXEndCapture` para intentar capturar llamadas a una función que se encuentren dentro de un intervalo de tiempo predefinido. Es posible que desee mostrar solo las capturas de las llamadas a una función que estén dentro de ese intervalo.

### Valor devuelto

Tipo: HRESULT

Indica si la captura se completó correctamente. Se devuelve S\_OK en caso de éxito. La operación es asincrónica y devolverá E\_PENDING hasta que la captura se detenga por completo. El título no debe salir ni iniciar una nueva captura mientras el resultado sea E\_PENDING.

## Comentarios

Use [PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture) para iniciar una captura de PIX.\
Para obtener más información sobre los requisitos para iniciar una captura de PIX, consulte la sección Comentarios de [PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture).

El siguiente ejemplo de C++ muestra cómo iniciar y finalizar una captura de 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

**Encabezado:** pix3.h

**Biblioteca:** pixevt.lib

**Plataformas compatibles:** consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

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


## Related topics

- [PIX3](/es/reference/tools/pix3/pix3_members.md)
- [XtfCaptureOutputEnd](/es/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputend-xtfapi-xbox-windows-m.md)
- [XtfCaptureOutputBegin](/es/reference/tools/xtf/xtfapi/functions/xtfcaptureoutputbegin-xtfapi-xbox-windows-m.md)
- [XUserDefaultAudioEndpointKind](/es/reference/system/xuser/enums/xuserdefaultaudioendpointkind.md)
- [Función PIXBeginEvent](/es/reference/tools/pix3/functions/pixbeginevent-overloads.md)