Macro TraceLoggingBinary (traceloggingprovider.h)

Article
08/26/2023

Macro wrapper TraceLogging qui ajoute un champ avec des données binaires à l’événement.

Syntaxe

void TraceLoggingBinary(
  [in]            pValue,
  [in]            cbValue,
  [in, optional]  __VA_ARGS__
);

Paramètres

[in] pValue

Pointeur vers les données à inclure dans l’événement.

[in] cbValue

Taille, en octets, des données à inclure dans l’événement.

[in, optional] __VA_ARGS__

Paramètres de nom, de description et d’étiquettes facultatifs pour la définition de champ.

TraceLoggingBinary peut être spécifié avec 2, 3, 4 ou 5 paramètres. Si aucun paramètre facultatif n’est spécifié, une valeur par défaut est utilisée. Par exemple, TraceLoggingBinary(&x.data, sizeof(x.data)) équivaut à TraceLoggingBinary(&x.data, sizeof(x.data), "&x.data", "", 0).

[in, optional] name

Nom à utiliser pour le champ d’événement. S’il est fourni, le paramètre name doit être un littéral de chaîne (et non une variable) et ne doit pas contenir de caractères « \0 ». S’il n’est pas fourni, le nom du champ d’événement sera basé sur pValue.
[in, optional] description

Description de la valeur du champ d’événement. S’il est fourni, le paramètre de description doit être un littéral de chaîne et sera inclus dans le PDB.
[in, optional] tags

Valeur entière constante au moment de la compilation. Les 28 bits faibles de la valeur seront inclus dans les métadonnées du champ. La sémantique de cette valeur est définie par le consommateur d’événements. Pendant le traitement des événements, cette valeur peut être récupérée à partir du champ Balises EVENT_PROPERTY_INFO .

Valeur de retour

None

Remarques

TraceLoggingBinary(pValue, cbValue, ...) peut être utilisé comme paramètre pour l’appel d’une macro TraceLoggingWrite . Chaque paramètre TraceLoggingBinary ajoute un champ à l’événement.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	traceloggingprovider.h

Voir aussi

TraceLoggingWrite

Macros du wrapper TraceLogging

Partager via