Macro TraceLoggingBinary (traceloggingprovider.h)

Articolo
08/26/2023

Macro wrapper traceLogging che aggiunge un campo con dati binari all'evento.

Sintassi

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

Parametri

[in] pValue

Puntatore ai dati da includere nell'evento.

[in] cbValue

Dimensioni, in byte, dei dati da includere nell'evento.

[in, optional] __VA_ARGS__

Nome facoltativo, descrizione e parametri di tag per la definizione del campo.

TraceLoggingBinary può essere specificato con 2, 3, 4 o 5 parametri. Se non viene specificato un parametro facoltativo, verrà usato un valore predefinito. Ad esempio, TraceLoggingBinary(&x.data, sizeof(x.data)) equivale a TraceLoggingBinary(&x.data, sizeof(x.data), "&x.data", "", 0).

[in, optional] name

Nome da usare per il campo evento. Se specificato, il parametro name deve essere un valore letterale stringa (non una variabile) e non deve contenere caratteri '\0'. Se non specificato, il nome del campo evento sarà basato su pValue.
[in, optional] description

Descrizione del valore del campo evento. Se specificato, il parametro di descrizione deve essere un valore letterale stringa e verrà incluso nel PDB.
[in, optional] tags

Valore intero costante compilazione.A compile-time integer value. I 28 bit bassi del valore verranno inclusi nei metadati del campo. La semantica di questo valore è definita dal consumer di eventi. Durante l'elaborazione degli eventi, questo valore può essere recuperato dal campo Tag di EVENT_PROPERTY_INFO .

Valore restituito

nessuno

Osservazioni

TraceLoggingBinary(pValue, cbValue, ...) può essere usato come parametro per una chiamata di una macro TraceLoggingWrite . Ogni parametro TraceLoggingBinary aggiunge un campo all'evento.

Requisiti


Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	traceloggingprovider.h

Vedi anche

TraceLoggingWrite

Macro wrapper traceLogging

Condividi tramite