Makro TraceLoggingBinary (traceloggingprovider.h)

  • Artikel

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