Skip to main content

​
AppCaptureRegisterMetadataPurged

Inscrit un gestionnaire d’événements pour les événements de purge des métadonnées.

​
Syntaxe

​
Paramètres

queue   _In_opt_
Type : XTaskQueueHandle File d’attente asynchrone pour gérer le travail asynchrone. Si elle n’est pas assignée, une file d’attente asynchrone par défaut sera créée. context   _In_
Type : void* Informations à transmettre à la fonction de rappel. Habituellement l’objet appelant. callback   _In_
Type : XAppCaptureMetadataPurgedCallback* Fonction de rappel à appeler une fois le travail asynchrone terminé. token   _Out_
Type : XTaskQueueRegistrationToken* Jeton identifiant le gestionnaire d’événements.

​
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.
Étant donné que la capture d’application historique est prise en charge, le système accumule les métadonnées écrites avec AppCaptureMetadataWriter même lorsqu’aucune capture ni diffusion n’est active. Lorsque, par exemple, une capture des 30 dernières secondes est écrite dans un fichier vidéo sur le disque, les métadonnées associées à la fenêtre de temps enregistrée sont incluses dans le fichier. Le système impose une limite à l’espace de stockage alloué par application pour le stockage des métadonnées accumulées. Vous pouvez obtenir l’espace de stockage actuellement disponible en vérifiant la propriété RemainingStorageBytesAvailable.
Lorsque tout l’espace alloué est rempli, le système commence à purger les métadonnées en fonction de la valeur XAppCaptureMetadataPriority, spécifiée lors de l’écriture des éléments de métadonnées, et de l’âge de chaque élément, afin de supprimer d’abord les données les plus anciennes et les moins importantes. Lorsque cela se produit, l’événement MetadataPurged est déclenché. En réponse à cet événement, vous pouvez choisir de réduire la quantité de métadonnées que votre application écrit, mais ce n’est pas obligatoire.

​
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
XAppCaptureUnRegisterMetadataPurged
Last modified on October 6, 2026