Skip to main content

XAppCaptureMetadataAddInt32Event

Ajoute un événement de métadonnées avec une valeur Int32 à votre capture d’application.

Syntaxe

Paramètres

name   _In_z_
Type : char*
Nom de l’événement ajouté à la chronologie de la capture d’application. value   _In_
Type : int32_t
Valeur de l’événement ajouté à la chronologie. Doit être de type Int32. priority   _In_
Type : XAppCaptureMetadataPriority
Priorité des métadonnées. Utilisée pour déterminer ce qui est sauvegardé lorsque les limites de stockage sont dépassées. Un membre de l’énumération XAppCaptureMetaDataPriority.

Valeur de retour

Type : HRESULT Résultat de la fonction.

Remarques

Cette fonction ne peut pas être appelée en toute sécurité sur un thread à délai critique. Pour plus d’informations, consultez Threads à délai critique.
Le système associe un événement de métadonnées à un horodatage lorsque cette méthode est appelée. Ces métadonnées servent à identifier les événements pendant les diffusions en direct et la lecture des captures, afin de catégoriser le contenu et d’y effectuer des recherches. Pour stocker une valeur entière qui s’applique à une période donnée, utilisez XAppCaptureMetaDataStartInt32State.
Les métadonnées peuvent être téléversées sur XBOX Live et/ou sauvegardées dans des fichiers .mp4 ou des captures d’écran, ou utilisées pendant une diffusion. Par conséquent, les renseignements privés des utilisateurs ne doivent jamais être consignés dans les métadonnées.

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
XAppCaptureMetadataAddDoubleEvent
XAppCaptureMetadataAddStringEvent
Last modified on October 6, 2026