TRACE_EVENT_INFO 구조체(tdh.h)

아티클
03/02/2024

이벤트에 대한 정보를 정의합니다.

구문

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