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

<Note>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](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

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

## 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 à durée critique](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

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


## Related topics

- [AppCaptureRegisterMetadataPurged](/reference/system/xappcapture/functions/xappcaptureregistermetadatapurged.md)
- [XAppCaptureUnRegisterMetadataPurged](/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged.md)
- [XAppCaptureMetadataPurgedCallback](/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback.md)
- [XAppCapture](/reference/system/xappcapture/xappcapture_members.md)
- [XAppCaptureMetadataPriority](/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)