> ## 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] L'adresse IP de la console.

*fullFileName*\
Type : PCWSTR

\[in] Le chemin complet et le nom du fichier dans lequel la vidéo sera écrite.

*numSeconds*\
Type : UINT32

\[in] Le 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 de retour

Type : HRESULT

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

| Code d'erreur | Description |
| - | - |
| 0x82323001 | Le service GameDVR s'est arrêté de façon 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 antérieur à 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 | Tentative de mise à jour d'un clip infonuagique pour lequel l'ID infonuagique 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 comprennent :<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 comprennent :<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 téléversement du clip a été retardé. Le téléversement sera tenté de nouveau plus tard. Les jeux peuvent ignorer cette erreur sans risque, ou l'utiliser pour informer l'utilisateur que la demande est toujours dans la file d'attente, mais qu'elle prendra plus de temps à se terminer. |
| 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é téléversé dans le nuage. |
| 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 l'enregistre 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-CA/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-CA/reference/tools/xtf/xtfconsolecontrol/functions/xtfcapturescreenshot)\
[Erreurs de transport XTF (rubrique sous NDA)](/fr-CA/tools/tools-console/commandlinetools/xtf-transport-errors)\
[API Xtf supplémentaires](/fr-CA/reference/tools/xtf/xtfapi/atoc-xtfapi)


## Related topics

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