TRACE_EVENT_INFO 구조체(tdh.h)
이벤트에 대한 정보를 정의합니다.
구문
typedef struct _TRACE_EVENT_INFO {
GUID ProviderGuid;
GUID EventGuid;
EVENT_DESCRIPTOR EventDescriptor;
DECODING_SOURCE DecodingSource;
ULONG ProviderNameOffset;
ULONG LevelNameOffset;
ULONG ChannelNameOffset;
ULONG KeywordsNameOffset;
ULONG TaskNameOffset;
ULONG OpcodeNameOffset;
ULONG EventMessageOffset;
ULONG ProviderMessageOffset;
ULONG BinaryXMLOffset;
ULONG BinaryXMLSize;
union {
ULONG EventNameOffset;
ULONG ActivityIDNameOffset;
};
union {
ULONG EventAttributesOffset;
ULONG RelatedActivityIDNameOffset;
};
ULONG PropertyCount;
ULONG TopLevelPropertyCount;
union {
TEMPLATE_FLAGS Flags;
struct {
ULONG Reserved : 4;
ULONG Tags : 28;
};
};
EVENT_PROPERTY_INFO EventPropertyInfoArray[ANYSIZE_ARRAY];
} TRACE_EVENT_INFO;
멤버
ProviderGuid
공급자를 식별하는 GUID입니다.
EventGuid
이벤트를 포함하는 MOF 클래스를 식별하는 GUID입니다. 공급자가 매니페스트를 사용하여 이벤트를 정의하는 경우 이 멤버는 GUID_NULL.
EventDescriptor
이벤트를 설명하는 EVENT_DESCRIPTOR 구조체입니다.
DecodingSource
이벤트의 데이터를 구문 분석하는 데 사용되는 원본(예: WMI MOF 클래스의 계측 매니페스트)을 식별하는 DECODING_SOURCE 열거 형 값입니다.
ProviderNameOffset
이 구조체의 시작부터 공급자 이름이 포함된 null로 끝나는 유니코드 문자열까지의 오프셋입니다.
LevelNameOffset
이 구조체의 시작부터 수준 이름을 포함하는 null로 끝나는 유니코드 문자열까지의 오프셋입니다. 가능한 이름은 LevelType의 비고를 참조하세요.
ChannelNameOffset
이 구조체의 시작부터 채널 이름이 포함된 null로 끝나는 유니코드 문자열까지의 오프셋입니다. 가능한 이름은 ChannelType의 설명을 참조하세요.
KeywordsNameOffset
이 구조체의 시작부터 키워드 이름을 포함하는 null로 끝나는 유니코드 문자열 목록까지의 오프셋입니다. 목록은 두 개의 NULL 문자로 종료됩니다. 가능한 이름은 KeywordType의 설명을 참조하세요.
TaskNameOffset
이 구조체의 시작부터 작업의 이름을 포함하는 null로 끝나는 유니코드 문자열까지의 오프셋입니다. 가능한 이름은 TaskType의 설명을 참조하세요.
OpcodeNameOffset
이 구조체의 시작부터 작업의 이름을 포함하는 null로 끝나는 유니코드 문자열까지의 오프셋입니다. 가능한 이름은 OpcodeType의 설명을 참조하세요.
EventMessageOffset
이 구조체의 시작부터 이벤트 메시지 문자열을 포함하는 null로 끝나는 유니코드 문자열까지의 오프셋입니다. 메시지 문자열이 없으면 오프셋이 0입니다. 메시지 문자열에 대한 자세한 내용은 EventDefinitionType에 대한 메시지 특성을 참조하세요.
메시지 문자열에는 삽입 시퀀스가 포함될 수 있습니다(예: %1 프린터에 연결할 수 없음). 삽입 시퀀스의 수는 대체에 사용할 이벤트 데이터의 속성을 식별합니다.
ProviderMessageOffset
이 구조체의 시작부터 지역화된 공급자 이름을 포함하는 null로 끝나는 유니코드 문자열까지의 오프셋입니다.
BinaryXMLOffset
예약되어 있습니다.
BinaryXMLSize
예약되어 있습니다.
EventNameOffset
ActivityIDNameOffset
이 구조체의 시작부터 MOF 클래스에 있는 활동 식별자의 속성 이름을 포함하는 null로 끝나는 유니코드 문자열까지의 오프셋입니다. 클래식 ETW 이벤트에만 지원됩니다.
EventAttributesOffset
RelatedActivityIDNameOffset
이 구조체의 시작부터 MOF 클래스의 관련 활동 식별자의 속성 이름을 포함하는 null로 끝나는 유니코드 문자열까지의 오프셋입니다. 레거시 ETW 이벤트에만 지원됩니다.
PropertyCount
EventPropertyInfoArray 배열의 요소 수입니다.
TopLevelPropertyCount
최상위 속성인 EventPropertyInfoArray 배열의 속성 수입니다. 이 숫자에는 구조체의 멤버가 포함되지 않습니다. 최상위 속성은 배열의 모든 멤버 속성 앞에 옵니다.
Flags
예약되어 있습니다.
Reserved
Tags
이벤트 메타데이터와 연결된 28비트 값입니다. 이 값은 이벤트 공급자가 이벤트 처리 도구에서 사용할 이벤트와 추가 의미 체계 데이터를 연결하는 데 사용할 수 있습니다. 예를 들어 태그 값이 5이면 이벤트에 디버깅 정보가 포함되어 있음을 나타낼 수 있습니다. 이 필드에 있는 모든 값의 의미 체계는 이벤트 공급자에 의해 정의됩니다.
EventPropertyInfoArray[ANYSIZE_ARRAY]
이벤트의 사용자 데이터의 각 속성에 대한 정보를 제공하는 EVENT_PROPERTY_INFO 구조체의 배열입니다.
설명
멤버가 정의되지 않은 경우 오프셋 값은 0입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | tdh.h |