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

# XtfCaptureRecordedGameClip

> XtfCaptureRecordedGameClip

# XtfCaptureRecordedGameClip

Récupère un clip vidéo à partir du GameDVR du jeu en cours d'exécution.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT XtfCaptureRecordedGameClip(
         PCWSTR address,
         PCWSTR fullFileName,
         UINT32 numSeconds
)  
```

<a id="parametersSection" />

### Paramètres

*address*\
Type : PCWSTR

\[in] Adresse IP de la console.

*fullFileName*\
Type : PCWSTR

\[in] Chemin d'accès complet et nom du fichier dans lequel la vidéo sera écrite.

*numSeconds*\
Type : UINT32

\[in] Nombre de secondes de vidéo à récupérer. La valeur minimale est de 6 secondes. La valeur maximale est de 300 secondes.

<a id="retvalSection" />

### Valeur renvoyée

Type : HRESULT

Retourne `S_OK` en cas de réussite ; sinon, retourne un code d'erreur. Les codes d'erreur possibles sont les suivants :

| Code d'erreur | Description |
| - | - |
| 0x82323001 | Le service GameDVR s'est arrêté de manière inattendue. |
| 0x82323002 | L'espace de stockage est insuffisant pour enregistrer un autre clip. |
| 0x82323003 | StartRecordAsync ne s'est pas terminé ou n'a pas été appelé à partir de cette instance d'ApplicationClipCapture avant l'appel de StopRecordAsync. |
| 0x82323004 | Il y a trop d'enregistrements simultanés. |
| 0x82323005 | Le texte de la réponse HTTP est trop volumineux. |
| 0x82323006 | Les informations sur un appel précédent à StartRecordingAsync sont manquantes. |
| 0x82323007 | StopRecordAsync n'a pas été appelé dans le délai imparti après StartRecordAsync. |
| 0x82323008 | L'appel asynchrone a échoué mais n'a pas retourné de code d'erreur. |
| 0x82323009 | Une mise à jour a été tentée sur un clip cloud dont l'ID cloud n'est pas disponible. |
| 0x8232300A | Une erreur s'est produite lors de l'écriture dans le fichier. |
| 0x8232300B | Aucune image à enregistrer n'a été trouvée. Les causes possibles sont les suivantes :<ul><li>Le jeu était en arrière-plan pendant la période spécifiée.</li><li>L'enregistrement a été demandé trop tôt après l'activation du jeu.</li></ul> |
| 0x8232300C | Aucune image à enregistrer n'a été trouvée. Les causes possibles sont les suivantes :<ul><li>Le jeu était en arrière-plan pendant la période spécifiée.</li><li>Le jeu n'était pas en cours d'exécution pendant la période spécifiée.</li></ul> |
| 0x8232300D | Les métadonnées du clip sont mal formatées. |
| 0x8232300E | L'heure de début est trop ancienne ou trop éloignée dans le futur. |
| 0x8232300F | La durée de l'enregistrement est trop courte ou trop longue. (6 à 300 secondes) |
| 0x82323010 | L'utilisateur ou le titre n'a pas accès au clip spécifié. |
| 0x82323011 | Il n'y a aucun champ à mettre à jour. |
| 0x82323012 | L'enregistrement était désactivé pendant la période demandée. |
| 0x82323013 | StartRecordAsync a été appelé alors qu'un autre enregistrement est en cours. |
| 0x82323014 | StopRecordAsync a été appelé mais aucun enregistrement n'a été démarré. |
| 0x82323015 | RecordTimespanAsync a été appelé alors qu'un autre enregistrement est en cours. |
| 0x82323016 | Le chargement du clip a été retardé. Le chargement sera retenté ultérieurement. Les jeux peuvent ignorer cette erreur en toute sécurité, ou l'utiliser pour informer l'utilisateur que la demande est toujours dans la file d'attente mais qu'elle prendra plus de temps. |
| 0x82323017 | Soit aucun titre n'est en cours d'exécution, soit le titre ne dispose pas des informations d'identification appropriées. |
| 0x82323018 | Le titre actuel a bloqué l'enregistrement. |
| 0x82323019 | Le clip n'a pas encore été chargé dans le cloud. |
| 0x8232301A | Un utilisateur invité a été spécifié pour une opération qui ne le permet pas. |
| 0x8232301B | Le GameDVR n'est pas disponible, car une diffusion est en cours. |
| 0x8C11040D | Le titre n'est pas en cours d'exécution sur la console cible. |

<a id="remarksSection" />

## Remarques

Pendant l'exécution d'un jeu, la console stocke automatiquement jusqu'à 300 secondes de vidéo dans une mémoire tampon vidéo FIFO. `XtfCaptureRecordedGameClip` récupère la quantité spécifiée de vidéo précédemment stockée dans la mémoire tampon et la stocke dans le fichier spécifié dans `fullFileName`. Le fichier est enregistré au format vidéo MP4. Pour plus d'informations sur l'utilisation de GameDVR pour capturer des clips vidéo, consultez [GameDVR et diffusion](/fr/build/console-features/game-dvr/gamedvr-broadcast).

<a id="requirements" />

## Configuration requise

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

**Bibliothèque :** XtfApi.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

<a id="seealsoSection" />

## Voir aussi

[XtfCaptureScreenshot](/fr/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot)\
[Erreurs de transport XTF (rubrique sous NDA)](/fr/tools/tools-console/commandlinetools/xtf-transport-errors)\
[API Xtf supplémentaires](/fr/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

- [XAppCaptureRecordClipResult](/fr/reference/system/xappcapture/structs/xappcapturerecordclipresult.md)
- [XAppCaptureRecordDiagnosticClip](/fr/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip.md)
- [XAppCaptureStartUserRecord](/fr/reference/system/xappcapture/functions/xappcapturestartuserrecord.md)
- [Game DVR et diffusion](/fr/build/console-features/game-dvr/gamedvr-broadcast.md)
- [XAppCapture](/fr/reference/system/xappcapture/xappcapture_members.md)