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

Arrête une capture contrôlée par programmation qui a été démarrée avec `PIXBeginCapture`.

## Syntaxe

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

### Paramètres

*discard*   \
Type : BOOL

Indique si la capture doit être ignorée :

* Si *discard* a la valeur TRUE, les données capturées sont ignorées et la capture n'est pas affichée dans PIX.
* Si *discard* a la valeur FALSE, les données capturées sont enregistrées et PIX affiche la capture obtenue.

Le paramètre *discard* est utile pour supprimer les captures qui ne répondent pas aux critères recherchés. Par exemple, vous pouvez utiliser `PIXBeginCapture` et `PIXEndCapture` pour tenter de capturer les appels à une fonction qui se situent dans une plage de temps prédéfinie. Vous pouvez souhaiter afficher uniquement les captures des appels à une fonction qui se situent dans cette plage.

### Valeur de retour

Type : HRESULT

Indique si la capture s'est terminée avec succès. S\_OK est retourné en cas de réussite. L'opération est asynchrone et retourne E\_PENDING jusqu'à ce que la capture soit complètement arrêtée. Le titre ne doit pas se fermer ni démarrer une nouvelle capture tant que le résultat est E\_PENDING.

## Remarques

Utilisez [PIXBeginCapture](/fr/reference/tools/pix3/functions/pixbegincapture) pour commencer une capture PIX.\
Pour plus d'informations sur les conditions requises pour démarrer une capture PIX, consultez la section Remarques de [PIXBeginCapture](/fr/reference/tools/pix3/functions/pixbegincapture).

L'exemple C++ suivant montre comment commencer et terminer une capture 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
}

```

## Configuration requise

**En-tête :** pix3.h

**Bibliothèque :** pixevt.lib

**Plateformes prises en charge :** consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[PIXBeginCapture](/fr/reference/tools/pix3/functions/pixbegincapture)\
[PIX3](/fr/reference/tools/pix3/pix3_members)\
[PIX (rubrique sous NDA)](/fr/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)