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

# PIXGpuCaptureNextFrame (famille XBOX One)

> Capture l'image suivante de données pour le GPU.

Capture l'image suivante de données provenant du GPU.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT PIXGpuCaptureNextFrame(  
         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 effectue une capture GPU PIX dans laquelle l'image unique suivante est capturée dans un fichier sur la console pour une analyse ultérieure, sans qu'il soit nécessaire d'appeler [PIXGpuBeginCapture](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_pixgpubegincapture) ou [PIXGpuEndCapture](/fr-CA/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. 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

[ID3D12CommandQueue](/fr-CA/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/id3d12commandqueue)\
[d3d12\_x](/fr-CA/reference/graphics/d3d12_x/d3d12_x_members)


## Related topics

- [XBOX Hang Investigation Tool (XHIT)](/fr-CA/tools/tools-console/xhit/index.md)
- [XAppCaptureVideoCaptureSettings](/fr-CA/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)
- [PIXCaptureParameters](/fr-CA/reference/tools/pix3/structs/pixcaptureparameters.md)
- [XAppCaptureGetVideoCaptureSettings](/fr-CA/reference/system/xappcapture/functions/xappcapturegetvideocapturesettings.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)