AppCaptureRegisterMetadataPurged

Syntaxe

HRESULT XAppCaptureRegisterMetadataPurged(  
         XTaskQueueHandle queue,  
         void* context,  
         XAppCaptureMetadataPurgedCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  

Paramètres

queue _In_opt_
Type : XTaskQueueHandle

File d’attente asynchrone chargée du travail asynchrone. Si elle n’est pas affectée, une file d’attente asynchrone par défaut est créée.

context _In_
Type : void*

Informations à transmettre à la fonction de rappel. Généralement 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ûr d’appeler cette fonction sur un thread à durée critique. Pour plus d’informations, consultez Threads à durée critique.

Comme la capture d’application historique est prise en charge, le système accumule les métadonnées écrites avec AppCaptureMetadataWriter même en l’absence de capture ou de diffusion active. Lorsque, par exemple, une capture des 30 secondes précédentes 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 stocker les 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é a été rempli, le système commence à purger les métadonnées en utilisant la valeur XAppCaptureMetadataPriority, spécifiée lors de l’écriture des éléments de métadonnées, ainsi que l’ancienneté de chaque élément, afin de supprimer en premier 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 écrites par votre application, mais ce n’est pas obligatoire.

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

AppCaptureRegisterMetadataPurged

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi

​AppCaptureRegisterMetadataPurged

​Syntaxe

​Paramètres

​Valeur de retour

​Remarques

​Configuration requise

​Documentation conceptuelle

​Voir aussi

AppCaptureRegisterMetadataPurged

Syntaxe

Paramètres

Valeur de retour

Remarques

Configuration requise

Documentation conceptuelle

Voir aussi