> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AppCaptureRegisterMetadataPurged

> AppCaptureRegisterMetadataPurged

# AppCaptureRegisterMetadataPurged

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

## Syntaxe

```cpp theme={null}
HRESULT XAppCaptureRegisterMetadataPurged(  
         XTaskQueueHandle queue,  
         void* context,  
         XAppCaptureMetadataPurgedCallback* callback,  
         XTaskQueueRegistrationToken* token  
)  
```

### 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

<Note>Il n'est pas sécuritaire d'appeler cette fonction sur un thread urgent. Pour plus d'informations, consultez [Threads urgents](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

É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](/fr-CA/reference/system/xappcapture/enums/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

* [Threads urgents](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[Vue d'ensemble de GameDVR](/fr-CA/build/console-features/game-dvr/gamedvr-broadcast)\
[Membres de XAppCapture](/fr-CA/reference/system/xappcapture/xappcapture_members)\
[XAppCaptureUnRegisterMetadataPurged](/fr-CA/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged)


## Related topics

- [AppCaptureRegisterMetadataPurged](/reference/system/xappcapture/functions/xappcaptureregistermetadatapurged.md)
- [XAppCaptureUnRegisterMetadataPurged](/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged.md)