XtfCaptureRecordedGameClip

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

Syntaxe

HRESULT XtfCaptureRecordedGameClip(
         PCWSTR address,
         PCWSTR fullFileName,
         UINT32 numSeconds
)  

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.

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 : Le jeu était en arrière-plan pendant la période spécifiée. L’enregistrement a été demandé trop tôt après l’activation du jeu.
0x8232300C	Aucune image à enregistrer n’a été trouvée. Les causes possibles sont les suivantes : Le jeu était en arrière-plan pendant la période spécifiée. Le jeu n’était pas en cours d’exécution pendant la période spécifiée.
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.

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.

Configuration requise

En-tête : xtfapi.h Bibliothèque : XtfApi.lib Plateformes prises en charge : Windows (pour les outils de console XBOX)

Voir aussi

XtfCaptureScreenshot
Erreurs de transport XTF (rubrique sous NDA)
API Xtf supplémentaires

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

XtfCaptureRecordedGameClip

XtfCaptureRecordedGameClip

Syntaxe

Paramètres

Valeur renvoyée

Remarques

Configuration requise

Voir aussi

​XtfCaptureRecordedGameClip

​Syntaxe

​Paramètres

​Valeur renvoyée

​Remarques

​Configuration requise

​Voir aussi

XtfCaptureRecordedGameClip

Syntaxe

Paramètres

Valeur renvoyée

Remarques

Configuration requise

Voir aussi