struktur EVENT_FILTER_HEADER (evntprov.h)

Menentukan data header yang harus mendahului data filter yang ditentukan dalam manifes instrumentasi.

Sintaks

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

Anggota

Id

Pengidentifikasi yang mengidentifikasi filter dalam manifes untuk filter skema. Atribut nilai elemen filter berisi pengidentifikasi.

Version

Nomor versi filter untuk filter yang diskema. Atribut versi elemen filter berisi nomor versi.

Reserved[5]

Dicadangkan

InstanceId

Pengidentifikasi yang mengidentifikasi sesi yang melewati filter. ETW menetapkan nilai ini; sesi harus mengatur anggota ini ke nol.

Penyedia menggunakan nilai ini untuk mengatur parameter FilterEventWriteEx untuk mencegah peristiwa ditulis ke sesi jika data peristiwa tidak cocok dengan kriteria filter (penyedia menentukan semantik bagaimana data filter digunakan dalam menentukan apakah peristiwa ditulis ke sesi).

Size

Ukuran, dalam byte, dari header ini dan data filter yang ditambahkan ke akhir header ini.

NextOffset

Offset dari awal objek filter ini ke objek filter berikutnya. Nilainya adalah nol jika tidak ada lagi blok filter. ETW menetapkan nilai ini; sesi harus mengatur anggota ini ke nol.

Keterangan

Data filter yang Anda berikan ke penyedia juga menyertakan header . Berikut ini memperlihatkan contoh bagaimana Anda akan menentukan filter yang berisi tiga bilangan bulat:

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

MY_FILTER FilterData;

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Header	evntprov.h

Lihat juga

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTrace

EnableTraceEx

EnableTraceEx2