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

# PIXGpuBeginCapture (famille XBOX One)

> Démarre le processus de capture GPU PIX.

Démarre le processus de capture GPU PIX.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT PIXGpuBeginCapture(  
         UINT Flags,  
         LPCWSTR lpOutputFileName  
)  
```

<a id="parametersSection" />

### Paramètres

*Flags*   \_In\_\
Type : UINT

Indicateurs contrôlant cette capture GPU PIX, sous la forme d'une combinaison OR au niveau du bit de constantes de l'énumération [D3D12XBOX\_PIX\_CAPTURE\_FLAGS](/fr/reference/graphics/d3d12_x/enums/d3d12xbox_pix_capture_flags).

*lpOutputFileName*   \_In\_z\_\
Type : LPCWSTR

Nom du fichier dans lequel stocker les données.

<a id="retvalSection" />

### Valeur renvoyée

Type : HRESULT

L'un des [codes de retour Direct3D 12](https://msdn.microsoft.com/library/windows/desktop/dn706075\(v=vs.85\).aspx).

<a id="remarksSection" />

## Remarques

Cette fonction démarre une capture GPU PIX au cours de laquelle plusieurs frames sont capturées jusqu'à l'appel de la méthode [PIXGpuEndCapture](/fr/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_pixgpuendcapture). Les données capturées par cette fonction sont stockées dans un fichier .xpix sur la console, mais uniquement après l'appel de la méthode `PIXGpuEndCapture`. Vous devez copier le fichier sur votre PC de développement avant de l'analyser. Pour plus d'informations sur les captures GPU PIX, consultez [Captures GPU PIX](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/tools-console/xbox-tools-and-apis/pix/gpu/pix-gpu-capture).

<a id="requirementsSection" />

## Configuration requise

**En-tête :** d3d12\_x.h

**Bibliothèque :** d3d12\_x.lib

**Plateformes prises en charge :** famille XBOX One

<a id="seealsoSection" />

## Voir aussi

[PIXGpuCaptureNextFrame](/fr/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_pixgpucapturenextframe)\
[ID3D12CommandQueue](/fr/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/id3d12commandqueue)\
[d3d12\_x](/fr/reference/graphics/d3d12_x/d3d12_x_members)


## Related topics

- [PIXBeginCapture](/reference/tools/pix3/functions/pixbegincapture.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [PIXBeginEvent reference](/reference/tools/pix3/functions/pixbeginevent_3.md)
- [PIXCaptureParameters](/reference/tools/pix3/structs/pixcaptureparameters.md)
- [PIXGetCaptureState](/reference/tools/pix3/functions/pixgetcapturestate.md)