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 du clip de diagnostic, en millisecondes. 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é qui en résulte.

​
Valeur de retour

Type : HRESULT Résultat de la fonction.

​
Remarques

Il n’est pas sécuritaire d’appeler cette fonction sur un thread urgent. Pour plus d’informations, consultez Threads urgents.
L’appel de cette fonction ne déclenche pas de notification d’interface utilisateur. Les clips sont enregistrés dans une partition accessible au 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 consoles commerciales, cette API retourne 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 le faire est d’ouvrir la Game Bar en appuyant sur Win+G, puis de cliquer sur l’icône Paramètres, d’aller dans l’onglet Capture et d’activer « Enregistrer en arrière-plan pendant que je joue ». Ensuite, vous devez marquer votre application comme un jeu. La meilleure façon de le faire est d’abord de lancer 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, allez dans 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 de XAppCapture
XAppCaptureRecordDiagnosticClipResult
Last modified on October 6, 2026