Makro TraceLoggingBinary (traceloggingprovider.h)

Artikel
08/26/2023

Makro pembungkus TraceLogging yang menambahkan bidang dengan data biner ke peristiwa.

Sintaks

void TraceLoggingBinary(
  [in]            pValue,
  [in]            cbValue,
  [in, optional]  __VA_ARGS__
);

Parameter

[in] pValue

Penunjuk ke data yang akan disertakan dalam peristiwa tersebut.

[in] cbValue

Ukuran, dalam byte, data yang akan disertakan dalam peristiwa tersebut.

[in, optional] __VA_ARGS__

Parameter nama, deskripsi, dan tag opsional untuk definisi bidang.

TraceLoggingBinary dapat ditentukan dengan 2, 3, 4, atau 5 parameter. Jika parameter opsional tidak ditentukan, default akan digunakan. Misalnya, TraceLoggingBinary(&x.data, sizeof(x.data)) sama dengan TraceLoggingBinary(&x.data, sizeof(x.data), "&x.data", "", 0).

[in, optional] name

Nama yang akan digunakan untuk bidang peristiwa. Jika disediakan, parameter nama harus berupa string harfiah (bukan variabel) dan tidak boleh berisi karakter '\0'. Jika tidak disediakan, nama bidang peristiwa akan didasarkan pada pValue.
[in, optional] description

Deskripsi nilai bidang peristiwa. Jika disediakan, parameter deskripsi harus berupa string harfiah dan akan disertakan dalam PDB.
[in, optional] tags

Nilai bilangan bulat konstanta waktu kompilasi. 28 bit rendah dari nilai akan disertakan dalam metadata bidang. Semantik nilai ini didefinisikan oleh konsumen peristiwa. Selama pemrosesan peristiwa, nilai ini dapat diambil dari bidang Tag EVENT_PROPERTY_INFO .

Nilai kembali

Tidak ada

Keterangan

TraceLoggingBinary(pValue, cbValue, ...) dapat digunakan sebagai parameter untuk pemanggilan makro TraceLoggingWrite . Setiap parameter TraceLoggingBinary menambahkan satu bidang ke peristiwa.

Persyaratan


Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	traceloggingprovider.h

Lihat juga

TraceLoggingWrite

Makro pembungkus TraceLogging

Bagikan melalui