Bagikan melalui

Fungsi TdhGetEventInformation (tdh.h)

  • Artikel

Mengambil metadata tentang suatu peristiwa.

Sintaks

TDHSTATUS TdhGetEventInformation(
  [in]      PEVENT_RECORD     Event,
  [in]      ULONG             TdhContextCount,
  [in]      PTDH_CONTEXT      TdhContext,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] PULONG            BufferSize
);

Parameter

[in] Event

Rekaman peristiwa diteruskan ke panggilan balik EventRecordCallback Anda. Untuk detailnya, lihat struktur EVENT_RECORD .

[in] TdhContextCount

Jumlah elemen dalam pTdhContext.

[in] TdhContext

Array nilai konteks hanya untuk peristiwa WPP atau ETW klasik; jika tidak, NULL. Untuk detailnya, lihat struktur TDH_CONTEXT . Array tidak boleh berisi jenis konteks duplikat.

[out] Buffer

Buffer yang dialokasikan pengguna untuk menerima informasi peristiwa. Untuk detailnya, lihat struktur TRACE_EVENT_INFO .

[in, out] BufferSize

Ukuran, dalam byte, dari buffer pBuffer . Jika fungsi berhasil, parameter ini menerima ukuran buffer yang digunakan. Jika buffer terlalu kecil, fungsi mengembalikan ERROR_INSUFFICIENT_BUFFER dan mengatur parameter ini ke ukuran buffer yang diperlukan. Jika ukuran buffer nol pada input, tidak ada data yang dikembalikan dalam buffer dan parameter ini menerima ukuran buffer yang diperlukan.

Mengembalikan nilai

Mengembalikan ERROR_SUCCESS jika berhasil. Jika tidak, fungsi ini mengembalikan salah satu kode pengembalian berikut selain yang lain.

Menampilkan kode Deskripsi
ERROR_INSUFFICIENT_BUFFER
 Ukuran buffer pBuffer terlalu kecil. Gunakan ukuran buffer yang diperlukan yang diatur dalam pBufferSize untuk mengalokasikan buffer baru.
ERROR_NOT_FOUND
 Skema untuk kejadian tidak ditemukan.
ERROR_INVALID_PARAMETER
 Satu atau beberapa parameter tidak valid.
ERROR_FILE_NOT_FOUND
 Atribut resourceFileName dalam manifes berisi lokasi biner penyedia. Saat Anda mendaftarkan manifes, lokasi ditulis ke registri. TDH tidak dapat menemukan biner berdasarkan lokasi terdaftar.
ERROR_WMI_SERVER_UNAVAILABLE
 Layanan WMI tidak tersedia.

Keterangan

Jika peristiwa tersebut adalah peristiwa WPP atau ETW warisan, Anda dapat menentukan informasi konteks yang digunakan untuk membantu mengurai informasi peristiwa. Acara ini adalah peristiwa WPP jika bendera EVENT_HEADER_FLAG_TRACE_MESSAGE diatur di anggota BenderaEVENT_HEADER (lihat anggota EventHeaderdari EVENT_RECORD). Acara ini adalah peristiwa ETW warisan jika bendera EVENT_HEADER_FLAG_CLASSIC_HEADER diatur.

Contoh

Untuk contoh yang memperlihatkan cara mengambil metadata tentang suatu peristiwa, lihat Menggunakan TdhFormatProperty untuk Mengonsumsi Data Peristiwa.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header tdh.h
Pustaka Tdh.lib
DLL Tdh.dll

Lihat juga

TdhGetEventMapInformation

TdhGetProperty