EVENT_FILTER_HEADER 구조체(evntprov.h)

  • 아티클

계측 매니페스트에 정의된 필터 데이터 앞에 와야 하는 헤더 데이터를 정의합니다.

구문

typedef struct _EVENT_FILTER_HEADER {
  USHORT    Id;
  UCHAR     Version;
  UCHAR     Reserved[5];
  ULONGLONG InstanceId;
  ULONG     Size;
  ULONG     NextOffset;
} EVENT_FILTER_HEADER, *PEVENT_FILTER_HEADER;

멤버

Id

스키마화된 필터에 대한 매니페스트의 필터를 식별하는 식별자입니다. 필터 요소의 값 특성에는 식별자가 포함됩니다.

Version

스키마화된 필터에 대한 필터의 버전 번호입니다. filter 요소의 version 특성에는 버전 번호가 포함됩니다.

Reserved[5]

예약됨

InstanceId

필터를 통과한 세션을 식별하는 식별자입니다. ETW는 이 값을 설정합니다. 세션은 이 멤버를 0으로 설정해야 합니다.

공급자는 이 값을 사용하여 EventWriteEx의 Filter 매개 변수를 설정하여 이벤트 데이터가 필터 조건과 일치하지 않는 경우 이벤트가 세션에 기록되지 않도록 합니다(공급자는 이벤트가 세션에 기록되는지 여부를 결정하는 데 필터 데이터가 사용되는 방식의 의미 체계를 결정합니다).

Size

이 헤더의 크기(바이트)와 이 헤더의 끝에 추가되는 필터 데이터입니다.

NextOffset

이 필터 개체의 시작 부분에서 다음 필터 개체로의 오프셋입니다. 필터 블록이 더 이상 없으면 값이 0입니다. ETW는 이 값을 설정합니다. 세션은 이 멤버를 0으로 설정해야 합니다.

설명

공급자에게 전달하는 필터 데이터에는 헤더도 포함됩니다. 다음은 세 개의 정수를 포함하는 필터를 정의하는 방법의 예를 보여 줍니다.

struct _MY_FILTER {
    EVENT_FILTER_HEADER FilterHeader;
    ULONG Int1;
    ULONG Int2;
    ULONG Int3;
} MY_FILTER, *MY_FILTER;

MY_FILTER FilterData;

요구 사항

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

추가 정보

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTrace

EnableTraceEx

EnableTraceEx2