TraceLogging 래퍼 매크로TraceLogging Wrapper Macros

TraceLogging 공급자에 대 한 래퍼 매크로를 나열 합니다.Lists the wrapper macros for TraceLogging providers.

TraceLogging 공급자를 사용 하 여 이벤트를 기록 하려면 TraceLogging write macros TraceLoggingWrite 또는 TraceLoggingWriteActivity를 사용 해야 합니다.In order to record events using TraceLogging providers, you need to use the TraceLogging write macros TraceLoggingWrite or TraceLoggingWriteActivity. 이러한 매크로는 모두 래퍼 매크로에서 이벤트 데이터를 래핑하는 데 필요 합니다.Both of these macros require you to wrap any event data in a wrapper macro. 서로 다른 데이터 형식에 대 한 여러 가지 래퍼 매크로가 있습니다.There are several different wrapper macros for different data types. TraceLogging 매크로의 전체 목록은 Tracelogging 매크로를 참조 하세요.For a complete list of TraceLogging macros, see TraceLogging Macros.

위의 래퍼 매크로 외에도 여러 매크로를 개별 데이터 형식에 사용할 수 있습니다.In addition to the wrapper macros above, several macros are available for individual data types. 이러한 매크로는 모두 TraceLoggingValue 매크로와 동일한 형식을 갖습니다.All of these macros have the same format as the TraceLoggingValue macro. TraceLoggingValue 매크로를 사용 하 여 사용할 적절 한 래퍼 매크로를 자동으로 검색 하거나 특정 매크로를 직접 사용할 수 있습니다.You can use the TraceLoggingValue macro to automatically detect the appropriate wrapper macro to use, or use the specific macro directly.

참고

TraceLoggingOptionGroup 은 tracelogging 정의 공급자 내에서 특별히 사용 하기 위한 것입니다 _ _ .TraceLoggingOptionGroup is specifically for use inside of TRACELOGGING_DEFINE_PROVIDER.

 

개별 래퍼 매크로는 다음과 같습니다.Here are the individual wrapper macros.

  • TraceLoggingInt8TraceLoggingInt8

  • TraceLoggingUInt8TraceLoggingUInt8

  • TraceLoggingInt16TraceLoggingInt16

  • TraceLoggingUInt16TraceLoggingUInt16

  • TraceLoggingInt32TraceLoggingInt32

  • TraceLoggingUInt32TraceLoggingUInt32

  • TraceLoggingInt64TraceLoggingInt64

  • TraceLoggingUInt64TraceLoggingUInt64

  • TraceLoggingFloat32TraceLoggingFloat32

  • TraceLoggingFloat64TraceLoggingFloat64

  • TraceLoggingBoolTraceLoggingBool

  • TraceLoggingFileTimeTraceLoggingFileTime

  • TraceLoggingGuidTraceLoggingGuid

  • TraceLoggingPointerTraceLoggingPointer

  • TraceLoggingSystemTimeTraceLoggingSystemTime

  • TraceLoggingHexInt8TraceLoggingHexInt8

  • TraceLoggingHexUInt8TraceLoggingHexUInt8

  • TraceLoggingHexInt32TraceLoggingHexInt32

  • TraceLoggingHexUInt32TraceLoggingHexUInt32

  • TraceLoggingHexInt64TraceLoggingHexInt64

  • TraceLoggingHexUInt64TraceLoggingHexUInt64

  • TraceLoggingWcharTraceLoggingWchar

  • TraceLoggingCharTraceLoggingChar

  • TraceLoggingIntPtrTraceLoggingIntPtr

  • TraceLoggingUIntPtrTraceLoggingUIntPtr

  • TraceLoggingBooleanTraceLoggingBoolean

  • TraceLoggingHexInt16TraceLoggingHexInt16

  • TraceLoggingHexUInt16TraceLoggingHexUInt16

  • TraceLoggingPidTraceLoggingPid

  • TraceLoggingTidTraceLoggingTid

  • TraceLoggingPortTraceLoggingPort

  • TraceLoggingWinErrorTraceLoggingWinError

  • TraceLoggingNTStatusTraceLoggingNTStatus

  • TraceLoggingHResultTraceLoggingHResult

  • TraceLoggingSocketAddressTraceLoggingSocketAddress

  • TraceLoggingSidTraceLoggingSid

  • TraceLoggingStringTraceLoggingString

  • TraceLoggingWideStringTraceLoggingWideString

  • TraceLoggingCountedStringTraceLoggingCountedString

  • TraceLoggingCountedWideStringTraceLoggingCountedWideString

  • TraceLoggingAnsiStringTraceLoggingAnsiString

  • TraceLoggingUnicodeStringTraceLoggingUnicodeString

  • TraceLoggingBinary (void * 데이터, 데이터 크기 (바이트 [ ), 선택적 ] 이름)이 매크로에 대 한 매개 변수는 위의 매개 변수와 다릅니다.TraceLoggingBinary(void *data, size of the data in bytes, [optional] name ) The parameters to this macro differ from those above. Name 매개 변수를 지정 하는 경우이 매개 변수는 변수가 아니라 문자열 리터럴이어야 하며 포함 된 null 문자를 포함할 수 없습니다.If the name parameter is specified, it must be a string literal (not a variable) and may not contain any embedded null characters. Name 매개 변수를 제공 하지 않으면 이름이 자동으로 생성 됩니다.If the name parameter is not provided, a name is generated automatically.

또한 TraceLogging API는 여러 매크로를 배열에 사용할 수 있도록 합니다.The TraceLogging API also makes several macros available for arrays. 이러한 배열에는 사용 하도록 선택한 래퍼 매크로에 따라 고정 길이 또는 가변 길이를 지정할 수 있습니다.These arrays can either have a fixed length or be of a variable length, depending on the wrapper macro you choose to use. 이러한 모든 래퍼 매크로는이 형식을 따릅니다.All of these wrapper macros follow this format.

TraceLoggingBooleanArray(pVals, cVals, name, desc, tags)

PVals 매개 변수는 데이터 배열을 가리키고 cVals 는 배열의 요소 수를 나타냅니다.The parameter pVals points to the array of data and cVals indicates the number of elements in the array. cVals 는 상수 여야 하며 변수가 될 수 없습니다.cVals must be a constant and cannot be a variable. 단일 값 래퍼 매크로, 이름, desc태그 는 선택적 매개 변수 이며 TraceLoggingValue 매크로에 설명 된 것과 동일한 제한을 따라야 합니다.As with the single value wrapper macros, name, desc, and tags are optional parameters and must follow the same restrictions as explained with the TraceLoggingValue macro.

  • TraceLoggingInt8FixedArrayTraceLoggingInt8FixedArray

  • TraceLoggingUInt8FixedArrayTraceLoggingUInt8FixedArray

  • TraceLoggingInt16FixedArrayTraceLoggingInt16FixedArray

  • TraceLoggingUInt16FixedArrayTraceLoggingUInt16FixedArray

  • TraceLoggingInt32FixedArrayTraceLoggingInt32FixedArray

  • TraceLoggingUInt32FixedArrayTraceLoggingUInt32FixedArray

  • TraceLoggingInt64FixedArrayTraceLoggingInt64FixedArray

  • TraceLoggingUInt64FixedArrayTraceLoggingUInt64FixedArray

  • TraceLoggingFloat32FixedArrayTraceLoggingFloat32FixedArray

  • TraceLoggingFloat64FixedArrayTraceLoggingFloat64FixedArray

  • TraceLoggingBoolFixedArrayTraceLoggingBoolFixedArray

  • TraceLoggingGuidFixedArrayTraceLoggingGuidFixedArray

  • TraceLoggingPointerFixedArrayTraceLoggingPointerFixedArray

  • TraceLoggingFileTimeFixedArrayTraceLoggingFileTimeFixedArray

  • TraceLoggingSystemTimeFixedArrayTraceLoggingSystemTimeFixedArray

  • TraceLoggingHexInt8FixedArrayTraceLoggingHexInt8FixedArray

  • TraceLoggingHexUInt8FixedArrayTraceLoggingHexUInt8FixedArray

  • TraceLoggingHexInt32FixedArrayTraceLoggingHexInt32FixedArray

  • TraceLoggingHexUInt32FixedArrayTraceLoggingHexUInt32FixedArray

  • TraceLoggingHexInt64FixedArrayTraceLoggingHexInt64FixedArray

  • TraceLoggingHexUInt64FixedArrayTraceLoggingHexUInt64FixedArray

  • TraceLoggingWcharFixedArrayTraceLoggingWcharFixedArray

  • TraceLoggingCharFixedArrayTraceLoggingCharFixedArray

  • TraceLoggingIntPtrFixedArrayTraceLoggingIntPtrFixedArray

  • TraceLoggingUIntPtrFixedArrayTraceLoggingUIntPtrFixedArray

  • TraceLoggingBooleanFixedArrayTraceLoggingBooleanFixedArray

  • TraceLoggingHexInt16FixedArrayTraceLoggingHexInt16FixedArray

  • TraceLoggingHexUInt16FixedArrayTraceLoggingHexUInt16FixedArray

  • TraceLoggingInt8ArrayTraceLoggingInt8Array

  • TraceLoggingUInt8ArrayTraceLoggingUInt8Array

  • TraceLoggingInt16ArrayTraceLoggingInt16Array

  • TraceLoggingUInt16ArrayTraceLoggingUInt16Array

  • TraceLoggingInt32ArrayTraceLoggingInt32Array

  • TraceLoggingUInt32ArrayTraceLoggingUInt32Array

  • TraceLoggingInt64ArrayTraceLoggingInt64Array

  • TraceLoggingUInt64ArrayTraceLoggingUInt64Array

  • TraceLoggingFloat32ArrayTraceLoggingFloat32Array

  • TraceLoggingFloat64ArrayTraceLoggingFloat64Array

  • TraceLoggingBoolArrayTraceLoggingBoolArray

  • TraceLoggingGuidArrayTraceLoggingGuidArray

  • TraceLoggingPointerArrayTraceLoggingPointerArray

  • TraceLoggingFileTimeArrayTraceLoggingFileTimeArray

  • TraceLoggingSystemTimeArrayTraceLoggingSystemTimeArray

  • TraceLoggingHexInt8ArrayTraceLoggingHexInt8Array

  • TraceLoggingHexUInt8ArrayTraceLoggingHexUInt8Array

  • TraceLoggingHexInt32ArrayTraceLoggingHexInt32Array

  • TraceLoggingHexUInt32ArrayTraceLoggingHexUInt32Array

  • TraceLoggingHexInt64ArrayTraceLoggingHexInt64Array

  • TraceLoggingHexUInt64ArrayTraceLoggingHexUInt64Array

  • TraceLoggingWcharArrayTraceLoggingWcharArray

  • TraceLoggingCharArrayTraceLoggingCharArray

  • TraceLoggingIntPtrArrayTraceLoggingIntPtrArray

  • TraceLoggingUIntPtrArrayTraceLoggingUIntPtrArray

  • TraceLoggingBooleanArrayTraceLoggingBooleanArray

  • TraceLoggingHexInt16ArrayTraceLoggingHexInt16Array

  • TraceLoggingHexUInt16ArrayTraceLoggingHexUInt16Array