Partager via

Macro TraceLoggingBinary (traceloggingprovider.h)

  • Article

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