> ## 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 du clip de diagnostic, en millisecondes.

*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-CA/reference/system/xappcapture/structs/xappcapturerecordclipresult)

Le clip de diagnostic enregistré qui en résulte.

### Valeur de retour

Type : HRESULT

Résultat de la fonction.

## Remarques

<Note>Il n'est pas sécuritaire d'appeler cette fonction sur un thread urgent. Pour plus d'informations, consultez [Threads urgents](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 au jeu. La structure [XAppCaptureRecordDiagnosticClipResult](/fr-CA/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 consoles commerciales, cette API retourne 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 le faire est d'ouvrir la Game Bar en appuyant sur Win+G, puis de cliquer sur l'icône Paramètres, d'aller dans l'onglet Capture et d'activer « Enregistrer en arrière-plan pendant que je joue ».
Ensuite, vous devez marquer votre application comme un jeu. La meilleure façon de le faire est d'abord de lancer 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, allez dans 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 urgents](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

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


## Related topics

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