Skip to main content

​
XAppCaptureRecordDiagnosticClip

Enregistre un clip de diagnostic à partir de votre application.

​
Syntaxe

​
Paramètres

startTime   _In_
Type : time_t Horodatage du début du clip de diagnostic. durationInMs   _In_
Type : uint32_t Durée en millisecondes du clip de diagnostic. filenamePrefix   _In_opt_
Type : char* Préfixe souhaité pour le nom de fichier, facultatif ; il sera ajouté au début du nom du fichier de diagnostic. result   _Out_
Type : XAppCaptureRecordClipResult* Le clip de diagnostic enregistré obtenu.

​
Valeur de retour

Type : HRESULT Résultat de la fonction.

​
Remarques

Il n’est pas sûr d’appeler cette fonction sur un thread à durée critique. Pour plus d’informations, consultez Threads à durée critique.
L’appel de cette fonction ne déclenche pas de notification d’interface utilisateur. Les clips sont enregistrés dans une partition accessible par le jeu. La structure XAppCaptureRecordDiagnosticClipResult contient un chemin de fichier que vous pouvez utiliser pour accéder au clip. Sur XBOX, cette fonction n’est disponible que sur les kits de développement. Sur les kits commerciaux, cette API renvoie immédiatement une erreur. Sur PC, vous devez activer l’enregistrement en arrière-plan pour votre application afin que cette fonction fonctionne. La meilleure façon de procéder consiste à ouvrir la Game Bar en appuyant sur Win+G, puis à cliquer sur l’icône Paramètres, à accéder à l’onglet Capture et à activer « Enregistrer en arrière-plan pendant que je joue ». Ensuite, vous devez marquer votre application comme un jeu. La meilleure façon de procéder consiste à lancer d’abord votre jeu. Pendant que le jeu a le focus, ouvrez la Game Bar en appuyant sur Win+G, puis cliquez sur l’icône Paramètres, accédez à l’onglet Général et cochez « Se souvenir qu’il s’agit d’un jeu ».

​
Configuration requise

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

​
Documentation conceptuelle

​
Voir aussi

Vue d’ensemble de GameDVR
Membres XAppCapture
XAppCaptureRecordDiagnosticClipResult
Last modified on October 6, 2026