struktur EVENT_PROPERTY_INFO (tdh.h)

Menyediakan informasi tentang satu properti peristiwa atau filter.

Sintaks

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;

Anggota

Flags

Bendera yang menunjukkan apakah properti terkandung dalam struktur atau array. Untuk nilai yang mungkin, lihat enumerasi PROPERTY_FLAGS .

NameOffset

Offset ke string Unicode yang dihentikan null yang berisi nama properti . Jika ini adalah properti peristiwa, offset berasal dari awal struktur TRACE_EVENT_INFO . Jika ini adalah properti filter, offset berasal dari awal struktur PROVIDER_FILTER_INFO .

nonStructType

Gunakan anggota ini jika bendera PropertyStruct di Bendera tidak diatur; jika tidak, gunakan anggota structType .

nonStructType.InType

Jenis data properti ini pada input. Untuk deskripsi jenis ini, lihat Keterangan di InputType.

Untuk deskripsi jenis ini, lihat Kualifikasi MOF Pelacakan Peristiwa.

TdhGetPropertySizeTdhGetPropertySize

nonStructType.OutType

Format output untuk properti ini. Jika nilainya TDH_OUTTYPE_NULL, gunakan jenis dalam sebagai format output. Untuk deskripsi jenis ini, lihat Keterangan di InputType.

Untuk deskripsi jenis ini, lihat Kualifikasi MOF Pelacakan Peristiwa.

nonStructType.MapNameOffset

Offset dari awal struktur TRACE_EVENT_INFO ke string Unicode yang dihentikan null yang berisi nama nilai atribut peta. Anda dapat meneruskan string ini ke TdhGetEventMapInformation untuk mengambil informasi tentang peta nilai.

structType

Gunakan anggota ini jika bendera PropertyStruct di Bendera diatur; jika tidak, gunakan anggota nonStructType .

structType.StructStartIndex

Indeks berbasis nol ke elemen array properti yang berisi anggota pertama struktur.

structType.NumOfStructMembers

Jumlah anggota dalam struktur.

structType.padding

Tidak digunakan.

customSchemaType

Gunakan anggota ini jika bendera PropertyHasCustomSchema di Bendera diatur; jika tidak, gunakan anggota nonStructType .

customSchemaType.InType

customSchemaType.OutType

Format output untuk properti ini. Jika nilainya TDH_OUTTYPE_NULL, gunakan jenis dalam sebagai format output. Untuk deskripsi jenis ini, lihat Keterangan di InputType.

Untuk deskripsi jenis ini, lihat Kualifikasi MOF Pelacakan Peristiwa.

customSchemaType.CustomSchemaOffset

Offset (dalam byte) dari awal struktur TRACE_EVENT_INFO ke informasi skema kustom. Informasi skema kustom akan berisi pengidentifikasi protokol 2 byte, diikuti dengan panjang skema 2 byte, diikuti oleh skema.

count

Jumlah elemen dalam array. Perhatikan bahwa nilai ini adalah 1 untuk properti yang tidak didefinisikan sebagai array.

countPropertyIndex

Indeks berbasis nol ke elemen array properti yang berisi jumlah elemen dalam array. Gunakan anggota ini jika bendera PropertyParamCount di Bendera diatur; jika tidak, gunakan anggota hitungan .

length

Ukuran properti, dalam byte. Perhatikan bahwa jenis berukuran variabel seperti string dan data biner memiliki panjang nol kecuali properti memiliki atribut panjang untuk secara eksplisit menunjukkan panjang sebenarnya. Struktur memiliki panjang nol.

lengthPropertyIndex

Indeks berbasis nol ke elemen array properti yang berisi nilai ukuran properti ini. Gunakan anggota ini jika bendera PropertyParamLength di Bendera diatur; jika tidak, gunakan anggota panjang .

Reserved

Dicadangkan.

Tags

Nilai 28-bit yang terkait dengan metadata bidang. Nilai ini hanya valid jika bendera PropertyHasTags diatur. Nilai ini dapat digunakan oleh penyedia peristiwa untuk mengaitkan data semantik tambahan dengan bidang untuk digunakan oleh alat pemrosesan peristiwa. Misalnya, nilai tag 1 mungkin menunjukkan bahwa bidang berisi nama pengguna. Semantik nilai apa pun di bidang ini ditentukan oleh penyedia peristiwa.

Keterangan

Filter tidak mendukung peta, struktur, atau array.

Persyaratan

Lihat juga

PROVIDER_FILTER_INFO

TRACE_EVENT_INFO