> ## 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 la frame suivante de données pour le GPU.

Capture la frame 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

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 effectue une capture GPU PIX au cours de laquelle la frame suivante unique est capturée dans un fichier sur la console pour une analyse ultérieure, sans avoir à appeler [PIXGpuBeginCapture](/fr/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_pixgpubegincapture) ou [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. 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

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


## Related topics

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