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

Les indicateurs qui contrôlent cette capture GPU PIX, sous forme de combinaison OR au niveau du bit de constantes d'énumération [D3D12XBOX\_PIX\_CAPTURE\_FLAGS](/fr-CA/reference/graphics/d3d12_x/enums/d3d12xbox_pix_capture_flags).

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

Le nom du fichier dans lequel stocker les données.

<a id="retvalSection" />

### Valeur de retour

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 dans laquelle plusieurs images sont capturées jusqu'à ce que la méthode [PIXGpuEndCapture](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_pixgpuendcapture) soit appelée. Les données capturées par cette fonction sont stockées dans un fichier .xpix sur la console, mais seulement après l'appel de la méthode `PIXGpuEndCapture`. Vous devez copier le fichier sur votre PC de développement avant l'analyse. 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-CA/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_pixgpucapturenextframe)\
[ID3D12CommandQueue](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/id3d12commandqueue)\
[d3d12\_x](/fr-CA/reference/graphics/d3d12_x/d3d12_x_members)


## Related topics

- [PIXBeginCapture](/fr-CA/reference/tools/pix3/functions/pixbegincapture.md)
- [XBOX Hang Investigation Tool (XHIT)](/fr-CA/tools/tools-console/xhit/index.md)
- [BeginQuery](/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_beginquery_public.md)
- [XAsyncBegin](/fr-CA/reference/system/xasyncprovider/functions/xasyncbegin.md)
- [Référence de PIXBeginEvent](/fr-CA/reference/tools/pix3/functions/pixbeginevent_3.md)