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

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

nonStructType.InType

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

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

TdhGetPropertySizeTdhGetPropertySize

nonStructType.OutType

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

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

nonStructType.MapNameOffset

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

structType

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

structType.StructStartIndex

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

structType.NumOfStructMembers

구조체의 멤버 수입니다.

structType.padding

사용되지 않습니다.

customSchemaType

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

customSchemaType.InType

customSchemaType.OutType

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

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

customSchemaType.CustomSchemaOffset

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

count

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

countPropertyIndex

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

length

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

lengthPropertyIndex

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

Reserved

예약되어 있습니다.

Tags

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

설명

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

요구 사항

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

추가 정보

PROVIDER_FILTER_INFO

TRACE_EVENT_INFO