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

# XAppCaptureRecordDiagnosticClip

> XAppCaptureRecordDiagnosticClip

# XAppCaptureRecordDiagnosticClip

Enregistre un clip de diagnostic à partir de votre application.

## Syntaxe

```cpp theme={null}
HRESULT XAppCaptureRecordDiagnosticClip(  
         time_t startTime,  
         uint32_t durationInMs,  
         const char* filenamePrefix,  
         XAppCaptureRecordClipResult* result  
)  
```

### Paramètres

*startTime*   \_In\_\
Type : time\_t

Horodatage du début du clip de diagnostic.

*durationInMs*   \_In\_\
Type : uint32\_t

Durée en millisecondes du clip de diagnostic.

*filenamePrefix*   \_In\_opt\_\
Type : char\*

Préfixe souhaité pour le nom de fichier, facultatif ; il sera ajouté au début du nom du fichier de diagnostic.

*result*   \_Out\_\
Type : [XAppCaptureRecordClipResult\*](/fr/reference/system/xappcapture/structs/xappcapturerecordclipresult)

Le clip de diagnostic enregistré obtenu.

### Valeur de retour

Type : HRESULT

Résultat de la fonction.

## Remarques

<Note>Il n'est pas sûr d'appeler cette fonction sur un thread à durée critique. Pour plus d'informations, consultez [Threads à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

L'appel de cette fonction ne déclenche pas de notification d'interface utilisateur. Les clips sont enregistrés dans une partition accessible par le jeu. La structure [XAppCaptureRecordDiagnosticClipResult](/fr/reference/system/xappcapture/structs/xappcapturerecordclipresult) contient un chemin de fichier que vous pouvez utiliser pour accéder au clip.
Sur XBOX, cette fonction n'est disponible que sur les kits de développement. Sur les kits commerciaux, cette API renvoie immédiatement une erreur.

Sur PC, vous devez activer l'enregistrement en arrière-plan pour votre application afin que cette fonction fonctionne. La meilleure façon de procéder consiste à ouvrir la Game Bar en appuyant sur Win+G, puis à cliquer sur l'icône Paramètres, à accéder à l'onglet Capture et à activer « Enregistrer en arrière-plan pendant que je joue ».
Ensuite, vous devez marquer votre application comme un jeu. La meilleure façon de procéder consiste à lancer d'abord votre jeu. Pendant que le jeu a le focus, ouvrez la Game Bar en appuyant sur Win+G, puis cliquez sur l'icône Paramètres, accédez à l'onglet Général et cochez « Se souvenir qu'il s'agit d'un jeu ».

## Configuration requise

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

**Bibliothèque :** xgameruntime.lib

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

## Documentation conceptuelle

* [Threads à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[Vue d'ensemble de GameDVR](/fr/build/console-features/game-dvr/gamedvr-broadcast)\
[Membres XAppCapture](/fr/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureRecordDiagnosticClipResult](/fr/reference/system/xappcapture/structs/xappcapturerecordclipresult)


## Related topics

- [XAppCaptureRecordDiagnosticClip](/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip.md)
- [XAppCaptureRecordClipResult](/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)