struktur TRACE_EVENT_INFO (tdh.h)
Menentukan informasi tentang peristiwa tersebut.
Sintaks
typedef struct _TRACE_EVENT_INFO {
GUID ProviderGuid;
GUID EventGuid;
EVENT_DESCRIPTOR EventDescriptor;
DECODING_SOURCE DecodingSource;
ULONG ProviderNameOffset;
ULONG LevelNameOffset;
ULONG ChannelNameOffset;
ULONG KeywordsNameOffset;
ULONG TaskNameOffset;
ULONG OpcodeNameOffset;
ULONG EventMessageOffset;
ULONG ProviderMessageOffset;
ULONG BinaryXMLOffset;
ULONG BinaryXMLSize;
union {
ULONG EventNameOffset;
ULONG ActivityIDNameOffset;
};
union {
ULONG EventAttributesOffset;
ULONG RelatedActivityIDNameOffset;
};
ULONG PropertyCount;
ULONG TopLevelPropertyCount;
union {
TEMPLATE_FLAGS Flags;
struct {
ULONG Reserved : 4;
ULONG Tags : 28;
};
};
EVENT_PROPERTY_INFO EventPropertyInfoArray[ANYSIZE_ARRAY];
} TRACE_EVENT_INFO;
Anggota
ProviderGuid
GUID yang mengidentifikasi penyedia.
EventGuid
GUID yang mengidentifikasi kelas MOF yang berisi peristiwa. Jika penyedia menggunakan manifes untuk menentukan peristiwanya, anggota ini GUID_NULL.
EventDescriptor
Struktur EVENT_DESCRIPTOR yang menjelaskan peristiwa.
DecodingSource
Nilai enumerasi DECODING_SOURCE yang mengidentifikasi sumber yang digunakan untuk mengurai data peristiwa (misalnya, manifes instrumentasi kelas MOF WMI).
ProviderNameOffset
Offset dari awal struktur ini ke string Unicode yang dihentikan null yang berisi nama penyedia.
LevelNameOffset
Offset dari awal struktur ini ke string Unicode yang dihentikan null yang berisi nama tingkat. Untuk kemungkinan nama, lihat Keterangan di LevelType.
ChannelNameOffset
Offset dari awal struktur ini ke string Unicode yang dihentikan null yang berisi nama saluran. Untuk kemungkinan nama, lihat Keterangan di ChannelType.
KeywordsNameOffset
Offset dari awal struktur ini ke daftar string Unicode yang dihentikan null yang berisi nama kata kunci. Daftar dihentikan dengan dua karakter NULL. Untuk kemungkinan nama, lihat Keterangan di KeywordType.
TaskNameOffset
Offset dari awal struktur ini ke string Unicode yang dihentikan null yang berisi nama tugas. Untuk kemungkinan nama, lihat Keterangan di TaskType.
OpcodeNameOffset
Offset dari awal struktur ini ke string Unicode yang dihentikan null yang berisi nama operasi. Untuk kemungkinan nama, lihat Keterangan di OpcodeType.
EventMessageOffset
Offset dari awal struktur ini ke string Unicode yang dihentikan null yang berisi string pesan peristiwa. Offset adalah nol jika tidak ada string pesan. Untuk informasi tentang string pesan, lihat atribut pesan untuk EventDefinitionType.
String pesan dapat berisi urutan sisipkan, misalnya, Tidak dapat tersambung ke printer %1. Jumlah urutan penyisipan mengidentifikasi properti dalam data peristiwa yang akan digunakan untuk penggantian.
ProviderMessageOffset
Offset dari awal struktur ini ke string Unicode yang dihentikan null yang berisi nama penyedia yang dilokalkan.
BinaryXMLOffset
Dicadangkan.
BinaryXMLSize
Dicadangkan.
EventNameOffset
ActivityIDNameOffset
Offset dari awal struktur ini ke string Unicode yang dihentikan null yang berisi nama properti pengidentifikasi aktivitas di kelas MOF. Didukung hanya untuk peristiwa ETW klasik.
EventAttributesOffset
RelatedActivityIDNameOffset
Offset dari awal struktur ini ke string Unicode yang dihentikan null yang berisi nama properti pengidentifikasi aktivitas terkait di kelas MOF. Didukung hanya untuk peristiwa ETW warisan.
PropertyCount
Jumlah elemen dalam array EventPropertyInfoArray .
TopLevelPropertyCount
Jumlah properti dalam array EventPropertyInfoArray yang merupakan properti tingkat atas. Jumlah ini tidak termasuk anggota struktur. Properti tingkat atas datang sebelum semua properti anggota dalam array.
Flags
Dicadangkan.
Reserved
Tags
Nilai 28-bit yang terkait dengan metadata peristiwa. Nilai ini dapat digunakan oleh penyedia peristiwa untuk mengaitkan data semantik tambahan dengan peristiwa untuk digunakan oleh alat pemrosesan peristiwa. Misalnya, nilai tag 5 mungkin menunjukkan bahwa peristiwa tersebut berisi informasi penelusuran kesalahan. Semantik nilai apa pun di bidang ini ditentukan oleh penyedia peristiwa.
EventPropertyInfoArray[ANYSIZE_ARRAY]
Array struktur EVENT_PROPERTY_INFO yang menyediakan informasi tentang setiap properti data pengguna peristiwa.
Keterangan
Nilai offset adalah nol jika anggota tidak ditentukan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Header | tdh.h |