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

추가 정보

TraceLoggingWrite

추적 로깅 래퍼 매크로