Skip to main content

XAppCaptureRecordTimespan

Effectue un enregistrement GameDVR. Aucune interface utilisateur n’indique qu’un tel enregistrement est en cours. L’utilisateur n’a pas accès à l’enregistrement. Au maximum 2 enregistrements de ce type peuvent exister à un moment donné. Une fois 2 enregistrements effectués, il faut appeler XAppCaptureCloseLocalStream pour fermer et supprimer un enregistrement avant de pouvoir en effectuer un autre. Cette fonction permet de capturer une activité passée ou future.

Syntaxe

Paramètres

startTimestamp _In_opt_
Type : const SYSTEMTIME *
L’horodatage à partir duquel démarrer l’enregistrement. Ce paramètre peut être null ; dans ce cas, le système calcule automatiquement l’heure de début comme étant durationInMilliseconds dans le passé, et l’enregistrement contiendra des activités passées. durationInMilliseconds _In_
Type : uint64_t
Durée de l’enregistrement en millisecondes. result _Out_
Type : XAppCaptureLocalResult *
À la fin de la fonction, contient les résultats de la capture. Consultez XAppCaptureReadLocalStream pour savoir comment lire l’enregistrement obtenu.

Valeur de retour

Type : HRESULT Résultat de la fonction. La fonction renvoie E_ACCESSDENIED si le paramètre GameDVR de l’utilisateur interdit aux jeux d’effectuer des captures.

Remarques

Il existe deux façons de transmettre le paramètre startTimestamp pour enregistrer une activité passée. Dans la première, null est transmis. Le système calcule automatiquement l’horodatage et enregistre les activités passées sur une durée de durationInMilliseconds jusqu’à maintenant.
Les clips les plus anciens sont supprimés lorsque l’espace alloué est rempli, afin de faire de la place aux nouveaux clips. Utilisez PLS (Persistent Local Storage), le stockage connecté (par exemple XGameSave ou XGameSaveFiles) ou un système de stockage similaire afin de conserver les clips pendant une période définie.
Dans la seconde, vous devez calculer l’horodatage de début souhaité en convertissant SYSTEMTIME ou FILETIME en ULARGE_INTEGER, en effectuant les calculs nécessaires, puis en reconvertissant ULARGE_INTEGER en SYSTEMTIME.
XAppCaptureRecordTimespan peut également servir à enregistrer les durationInMilliseconds prochaines millisecondes d’activité en spécifiant l’heure système actuelle comme startTimestamp.
Consultez XAppCaptureLocalResult et XAppCaptureReadLocalStream

Configuration requise

En-tête : XAppCapture.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : consoles de la famille XBOX One et consoles XBOX Series

Voir aussi

Membres XAppCapture
Last modified on October 6, 2026