Macro TraceLoggingValue (traceloggingprovider.h)

Articolo
08/26/2023

Macro wrapper TraceLogging per C++ che aggiunge un campo con un tipo dedotto automaticamente all'evento.

Sintassi

void TraceLoggingValue(
  [in]            value,
  [in, optional]  __VA_ARGS__
);

Parametri

[in] value

Valore del campo dell'evento.

[in, optional] __VA_ARGS__

Parametri di nome, descrizione e tag facoltativi per la definizione del campo.

TraceLoggingValue può essere specificato con 1, 2, 3 o 4 parametri. Se non viene specificato un parametro, verrà utilizzato un valore predefinito. Ad esempio, TraceLoggingValue(a+b) equivale a TraceLoggingValue(a+b, "a+b", "", 0).

[in, optional] name

Nome da utilizzare per il campo dell'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 sul valore.
[in, optional] description

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

Valore intero costante in fase di compilazione. 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 EVENT_PROPERTY_INFO .

Valore restituito

nessuno

Osservazioni

Nel codice TraceLoggingValue(value, ...) C++ può essere usato come parametro per una chiamata di una macro TraceLoggingWrite . Ogni parametro TraceLoggingValue aggiunge un campo all'evento.

Il tipo del campo nell'evento ETW viene dedotto automaticamente dal tipo dell'espressione valore . In base al tipo di valore, TraceLoggingValue(value, ...) equivale a una delle macro wrapper TraceLogging standard come indicato di seguito:

Tipo di valore	Equivalente a	Note
`bool`	TraceLoggingBoolean
`char`	TraceLoggingChar	Solo per char, non per char signed char o unsigned char.
`char16_t`	TraceLoggingChar16
`wchar_t`	TraceLoggingWChar	Solo per le wchar_t native, non per USHORT.
`intNN_t`	TraceLoggingIntNN	Per caratteri firmati, short, int, long e long.
`uintNN_t`	TraceLoggingUIntNN	Per unsigned char, short, int, long e long.
`float`	TraceLoggingFloat32
`double`	TraceLoggingFloat64
`GUID`	TraceLoggingGuid
`FILETIME`	TraceLoggingFileTime
`SYSTEMTIME`	TraceLoggingSystemTime
`SID*`	TraceLoggingSid	Deve essere diverso da NULL e deve puntare a un oggetto valido `SID`.
`void*`	TraceLoggingPointer	Registra il valore del puntatore, non i dati a cui si fa riferimento.
`char*`	TraceLoggingString	Stringa con terminazione zero CP_ACP. NULL viene considerato come `""`.
`char16_t*`	TraceLoggingString16	Stringa UTF-16 con terminazione zero. NULL viene considerato come `u""`.
`wchar_t*`	TraceLoggingWideString	Stringa UTF-16 con terminazione zero. NULL viene considerato come `L""`.

Requisiti

Requisito	Valore
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