TraceLoggingValue 매크로(traceloggingprovider.h)
자동으로 추론된 형식의 필드를 이벤트에 추가하는 C++용 TraceLogging 래퍼 매크로입니다.
구문
void TraceLoggingValue(
[in] value,
[in, optional] __VA_ARGS__
);
매개 변수
[in] value
이벤트 필드 값입니다.
[in, optional] __VA_ARGS__
필드 정의에 대한 선택적 이름, 설명 및 태그 매개 변수입니다.
TraceLoggingValue는 1, 2, 3 또는 4 매개 변수로 지정할 수 있습니다. 매개 변수를 지정하지 않으면 기본값이 사용됩니다. 예를 들어 TraceLoggingValue(a+b)는 TraceLoggingValue(a+b, "a+b", "", 0)와 같습니다.
[in, optional] name이벤트 필드에 사용할 이름입니다. 제공된 경우 name 매개 변수는 문자열 리터럴(변수 아님)이어야 하며 '\0' 문자를 포함하지 않아야 합니다. 제공되지 않으면 이벤트 필드 이름은 값을 기반으로 합니다.
[in, optional] description이벤트 필드 값에 대한 설명입니다. 제공된 경우 description 매개 변수는 문자열 리터럴이어야 하며 PDB에 포함됩니다.
[in, optional] tags컴파일 시간 상수 정수 값입니다. 낮은 28비트 값은 필드의 메타데이터에 포함됩니다. 이 값의 의미 체계는 이벤트 소비자에 의해 정의됩니다. 이벤트 처리 중에 이 값은 EVENT_PROPERTY_INFO 태그 필드에서 검색할 수 있습니다.
반환 값
없음
설명
C++ 코드 TraceLoggingValue(value, ...) 에서 을 TraceLoggingWrite 매크로 호출에 대한 매개 변수로 사용할 수 있습니다. 각 TraceLoggingValue 매개 변수는 이벤트에 하나의 필드를 추가합니다.
ETW 이벤트의 필드 형식은 값 식의 형식에서 자동으로 추론됩니다. 값TraceLoggingValue(value, ...) 형식에 따라 는 다음과 같이 표준 TraceLogging 래퍼 매크로 중 하나에 해당합니다.
| 값 형식 | Equivalent to | 참고 |
|---|---|---|
bool |
TraceLoggingBoolean | |
char |
TraceLoggingChar | 서명된 char 또는 서명되지 않은 문자의 경우, char에만 해당합니다. |
char16_t |
TraceLoggingChar16 | |
wchar_t |
TraceLoggingWChar | USHORT용이 아닌 네이티브 wchar_t만 해당합니다. |
intNN_t |
TraceLoggingIntNN | 서명된 char, short, int, long 및 long의 경우 |
uintNN_t |
TraceLoggingUIntNN | 부호 없는 char, short, int, long 및 long의 경우 |
float |
TraceLoggingFloat32 | |
double |
TraceLoggingFloat64 | |
GUID |
TraceLoggingGuid | |
FILETIME |
TraceLoggingFileTime | |
SYSTEMTIME |
TraceLoggingSystemTime | |
SID* |
TraceLoggingSid | NULL이 아니어야 하며 유효한 SID를 가리킵니다. |
void* |
TraceLoggingPointer | 참조된 데이터가 아닌 포인터 값을 기록합니다. |
char* |
TraceLoggingString | 0으로 끝나는 CP_ACP 문자열입니다. NULL은 로 ""처리됩니다. |
char16_t* |
TraceLoggingString16 | 0으로 종료된 UTF-16 문자열입니다. NULL은 로 u""처리됩니다. |
wchar_t* |
TraceLoggingWideString | 0으로 종료된 UTF-16 문자열입니다. NULL은 로 L""처리됩니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | traceloggingprovider.h |