다음을 통해 공유


EVENT_PROPERTY_INFO 구조체(tdh.h)

이벤트 또는 필터의 단일 속성에 대한 정보를 제공합니다.

구문

typedef struct _EVENT_PROPERTY_INFO {
  PROPERTY_FLAGS Flags;
  ULONG          NameOffset;
  union {
    struct {
      USHORT InType;
      USHORT OutType;
      ULONG  MapNameOffset;
    } nonStructType;
    struct {
      USHORT StructStartIndex;
      USHORT NumOfStructMembers;
      ULONG  padding;
    } structType;
    struct {
      USHORT InType;
      USHORT OutType;
      ULONG  CustomSchemaOffset;
    } customSchemaType;
  };
  union {
    USHORT count;
    USHORT countPropertyIndex;
  };
  union {
    USHORT length;
    USHORT lengthPropertyIndex;
  };
  union {
    ULONG Reserved;
    struct {
      ULONG Tags : 28;
    };
  };
} EVENT_PROPERTY_INFO;

멤버

Flags

속성이 구조체 또는 배열에 포함되어 있는지 여부를 나타내는 플래그입니다. 가능한 값은 PROPERTY_FLAGS 열거형을 참조하세요.

NameOffset

속성의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 오프셋입니다. 이벤트 속성인 경우 오프셋은 TRACE_EVENT_INFO 구조체의 시작 부분부터 시작됩니다. 필터 속성인 경우 오프셋은 PROVIDER_FILTER_INFO 구조체의 시작 부분부터 시작됩니다.

nonStructType

FlagsPropertyStruct 플래그가 설정되지 않은 경우 다음 멤버를 사용합니다. 그렇지 않으면 structType 멤버를 사용합니다.

nonStructType.InType

입력 시 이 속성의 데이터 형식입니다. 이러한 형식에 대한 설명은 InputType의 비고를 참조하세요.

이러한 형식에 대한 설명은 이벤트 추적 MOF 한정자를 참조하세요.

TdhGetPropertySizeTdhGetPropertySize

nonStructType.OutType

이 속성의 출력 형식입니다. 값이 TDH_OUTTYPE_NULL 경우 형식의 를 출력 형식으로 사용합니다. 이러한 형식에 대한 설명은 InputType의 비고를 참조하세요.

이러한 형식에 대한 설명은 이벤트 추적 MOF 한정자를 참조하세요.

nonStructType.MapNameOffset

TRACE_EVENT_INFO 구조체의 시작 부분에서 map 특성 값의 이름을 포함하는 null로 끝나는 유니코드 문자열로 오프셋됩니다. 이 문자열을 TdhGetEventMapInformation 에 전달하여 값 맵에 대한 정보를 검색할 수 있습니다.

structType

FlagsPropertyStruct 플래그가 설정된 경우 이러한 멤버를 사용합니다. 그렇지 않으면 nonStructType 멤버를 사용합니다.

structType.StructStartIndex

구조체의 첫 번째 멤버를 포함하는 속성 배열의 요소에 대한 인덱스(0부터 시작)입니다.

structType.NumOfStructMembers

구조체의 멤버 수입니다.

structType.padding

사용되지 않습니다.

customSchemaType

FlagsPropertyHasCustomSchema 플래그가 설정된 경우 이러한 멤버를 사용합니다. 그렇지 않으면 nonStructType 멤버를 사용합니다.

customSchemaType.InType

customSchemaType.OutType

이 속성의 출력 형식입니다. 값이 TDH_OUTTYPE_NULL 경우 형식의 를 출력 형식으로 사용합니다. 이러한 형식에 대한 설명은 InputType의 비고를 참조하세요.

이러한 형식에 대한 설명은 이벤트 추적 MOF 한정자를 참조하세요.

customSchemaType.CustomSchemaOffset

TRACE_EVENT_INFO 구조체의 시작부터 사용자 지정 스키마 정보까지 오프셋(바이트)입니다. 사용자 지정 스키마 정보에는 2 바이트 프로토콜 식별자, 2 바이트 스키마 길이, 스키마가 포함됩니다.

count

배열의 요소 수입니다. 이 값은 배열로 정의되지 않은 속성의 경우 1입니다.

countPropertyIndex

배열의 요소 수를 포함하는 속성 배열의 요소에 대한 인덱스(0부터 시작)입니다. FlagsPropertyParamCount 플래그가 설정된 경우 이 멤버를 사용합니다. 그렇지 않으면 count 멤버를 사용합니다.

length

속성의 크기(바이트)입니다. 문자열 및 이진 데이터와 같은 변수 크기의 형식은 속성에 실제 길이를 명시적으로 나타내는 length 특성이 없는 한 길이가 0입니다. 구조체의 길이는 0입니다.

lengthPropertyIndex

이 속성의 크기 값을 포함하는 속성 배열의 요소에 대한 인덱스(0부터 시작)입니다. FlagsPropertyParamLength 플래그가 설정된 경우 이 멤버를 사용합니다. 그렇지 않으면 길이 멤버를 사용합니다.

Reserved

예약되어 있습니다.

Tags

필드 메타데이터와 연결된 28비트 값입니다. 이 값은 PropertyHasTags 플래그가 설정된 경우에만 유효합니다. 이 값은 이벤트 공급자가 이벤트 처리 도구에서 사용할 필드와 추가 의미 체계 데이터를 연결하는 데 사용할 수 있습니다. 예를 들어 태그 값이 1이면 필드에 사용자 이름이 포함되어 있음을 나타낼 수 있습니다. 이 필드에 있는 모든 값의 의미 체계는 이벤트 공급자에 의해 정의됩니다.

설명

필터는 맵, 구조체 또는 배열을 지원하지 않습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
머리글 tdh.h

추가 정보

PROVIDER_FILTER_INFO

TRACE_EVENT_INFO