Share via

struktur EVENT_HEADER_EXTENDED_DATA_ITEM (evntcons.h)

  • Artikel

Menentukan data yang diperluas yang dikumpulkan Event Tracing for Windows (ETW) sebagai bagian dari data peristiwa.

Sintaks

typedef struct _EVENT_HEADER_EXTENDED_DATA_ITEM {
  USHORT    Reserved1;
  USHORT    ExtType;
  struct {
    USHORT Linkage : 1;
    USHORT Reserved2 : 15;
  };
  USHORT    DataSize;
  ULONGLONG DataPtr;
} EVENT_HEADER_EXTENDED_DATA_ITEM, *PEVENT_HEADER_EXTENDED_DATA_ITEM;

Anggota

Reserved1

Dicadangkan.

ExtType

Jenis data yang diperluas. Berikut ini adalah nilai yang mungkin.

Nilai Makna
EVENT_HEADER_EXT_TYPE_RELATED_ACTIVITYID
 Anggota DataPtr menunjuk ke struktur EVENT_EXTENDED_ITEM_RELATED_ACTIVITYID yang berisi pengidentifikasi aktivitas terkait jika Anda memanggil EventWriteTransfer untuk menulis peristiwa.
EVENT_HEADER_EXT_TYPE_SID
 Anggota DataPtr menunjuk ke struktur SID yang berisi pengidentifikasi keamanan (SID) pengguna yang mencatat peristiwa. ETW menyertakan SID jika Anda mengatur parameter EnableProperty dari EnableTraceEx ke EVENT_ENABLE_PROPERTY_SID.
EVENT_HEADER_EXT_TYPE_TS_ID
 Anggota DataPtr menunjuk ke struktur EVENT_EXTENDED_ITEM_TS_ID yang berisi pengidentifikasi sesi terminal. ETW menyertakan pengidentifikasi sesi terminal jika Anda mengatur parameter EnableProperty dari EnableTraceEx ke EVENT_ENABLE_PROPERTY_TS_ID.
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO
 Anggota DataPtr menunjuk ke struktur EVENT_EXTENDED_ITEM_INSTANCE yang berisi pengidentifikasi aktivitas jika Anda memanggil TraceEventInstance untuk menulis peristiwa.
EVENT_HEADER_EXT_TYPE_STACK_TRACE32
 Anggota DataPtr menunjuk ke struktur EVENT_EXTENDED_ITEM_STACK_TRACE32 yang berisi tumpukan panggilan jika peristiwa diambil di komputer 32-bit.
EVENT_HEADER_EXT_TYPE_STACK_TRACE64
 Anggota DataPtr menunjuk ke struktur EVENT_EXTENDED_ITEM_STACK_TRACE64 yang berisi tumpukan panggilan jika peristiwa diambil di komputer 64-bit.
EVENT_HEADER_EXT_TYPE_EVENT_SCHEMA_TL
 Anggota DataPtr menunjuk ke item header yang diperluas yang berisi informasi metadata peristiwa TraceLogging.
EVENT_HEADER_EXT_TYPE_PROV_TRAITS
 Anggota DataPtr menunjuk ke item header yang diperluas yang berisi data sifat penyedia, misalnya sifat yang diatur melalui EventSetInformation(EventProviderSetTraits) atau ditentukan melalui EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATA.
EVENT_HEADER_EXT_TYPE_EVENT_KEY
 Anggota DataPtr menunjuk ke struktur EVENT_EXTENDED_ITEM_EVENT_KEY yang berisi pengidentifikasi peristiwa unik yang merupakan skalar 64-bit.

EVENT_ENABLE_PROPERTY_EVENT_KEY EnableProperty perlu diteruskan untuk panggilan EnableTrace untuk penyedia tertentu guna mengaktifkan fitur ini.
EVENT_HEADER_EXT_TYPE_PROCESS_START_KEY
 Anggota DataPtr menunjuk ke struktur EVENT_EXTENDED_ITEM_PROCESS_START_KEY yang berisi pengidentifikasi proses unik (unik di seluruh sesi boot). Pengidentifikasi ini adalah skalar 64-bit.

EVENT_ENABLE_PROPERTY_PROCESS_START_KEY EnableProperty perlu diteruskan untuk panggilan EnableTrace untuk penyedia tertentu guna mengaktifkan fitur ini.

Linkage

Dicadangkan.

Reserved2

Dicadangkan.

DataSize

Ukuran, dalam byte, dari data yang diperluas yang dituju oleh DataPtr .

DataPtr

Arahkan ke data yang diperluas. Anggota ExtType menentukan jenis data yang diperluas tempat anggota ini menunjuk.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Header evntcons.h (termasuk Evntcons.h)

Lihat juga

EVENT_RECORD