TraceLoggingBinary 매크로(traceloggingprovider.h)
이진 데이터가 있는 필드를 이벤트에 추가하는 TraceLogging 래퍼 매크로입니다.
구문
void TraceLoggingBinary(
[in] pValue,
[in] cbValue,
[in, optional] __VA_ARGS__
);
매개 변수
[in] pValue
이벤트에 포함할 데이터에 대한 포인터입니다.
[in] cbValue
이벤트에 포함할 데이터의 크기(바이트)입니다.
[in, optional] __VA_ARGS__
필드 정의에 대한 선택적 이름, 설명 및 태그 매개 변수입니다.
TraceLoggingBinary는 2, 3, 4 또는 5 매개 변수로 지정할 수 있습니다. 선택적 매개 변수를 지정하지 않으면 기본값이 사용됩니다. 예를 들어 TraceLoggingBinary(&x.data, sizeof(x.data))
는 TraceLoggingBinary(&x.data, sizeof(x.data), "&x.data", "", 0)
와 같습니다.
[in, optional] name
이벤트 필드에 사용할 이름입니다. 제공된 경우 name 매개 변수는 문자열 리터럴(변수 아님)이어야 하며 '\0' 문자를 포함하지 않아야 합니다. 제공되지 않으면 이벤트 필드 이름은 pValue를 기반으로 합니다.
[in, optional] description
이벤트 필드 값에 대한 설명입니다. 제공된 경우 description 매개 변수는 문자열 리터럴이어야 하며 PDB에 포함됩니다.
[in, optional] tags
컴파일 시간 상수 정수 값입니다. 낮은 28비트 값은 필드의 메타데이터에 포함됩니다. 이 값의 의미 체계는 이벤트 소비자에 의해 정의됩니다. 이벤트 처리 중에 이 값은 EVENT_PROPERTY_INFO 태그 필드에서 검색할 수 있습니다.
반환 값
없음
설명
TraceLoggingBinary(pValue, cbValue, ...)
는 TraceLoggingWrite 매크로 호출에 대한 매개 변수로 사용할 수 있습니다. 각 TraceLoggingBinary 매개 변수는 이벤트에 하나의 필드를 추가합니다.
요구 사항
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | traceloggingprovider.h |