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

추가 정보

TraceLoggingWrite

추적 로깅 래퍼 매크로