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 |