Skip to main content

XAppCaptureStartUserRecord

Effectue un enregistrement comme si l’utilisateur l’avait déclenché. Si le joueur suspend ou restreint son jeu pendant qu’un enregistrement est en cours, l’enregistrement est arrêté. L’enregistrement est sauvegardé dans la partition utilisateur. Les paramètres de capture sont basés sur les paramètres GameDVR. Une fois la limite d’enregistrements simultanés atteinte, il faut appeler XAppCaptureStopUserRecord ou XAppCaptureCancelUserRecord avant de pouvoir démarrer un autre enregistrement. La prise en charge de cette API sous Windows sera ajoutée dans une version ultérieure.

Syntaxe

Paramètres

requestingUser _In_
Type : XUserHandle
Handle représentant l’utilisateur qui demande l’enregistrement. localIdBufferLength _In_
Type : uint32_t
La longueur de la mémoire tampon recevant l’ID local de l’enregistrement. localIdBuffer _Out_
Type : char*
Mémoire tampon contenant l’ID local qui spécifie l’opération d’enregistrement en cours.

Valeur de retour

Type : HRESULT Résultat de la fonction. Consultez Codes d’erreur XAppCapture pour les valeurs de retour autres que S_OK.

Remarques

Une fois la fonction terminée avec succès, localIdOfUserRecording contient l’ID local de l’enregistrement, qui doit être conservé pour arrêter un enregistrement spécifique avec XAppCaptureStopUserRecord ou XAppCaptureCancelUserRecord.
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.

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