Antarmuka ITraceDataCollector (pla.h)

Mengumpulkan peristiwa pelacakan dari penyedia terdaftar.

Antarmuka ini mendefinisikan sesi pelacakan. Sesi dimulai saat kumpulan pengumpul data berjalan. Pengumpulan penyedia data pelacakan menentukan penyedia yang ingin Anda aktifkan ke sesi saat sesi berjalan.

Untuk membuat pengumpul data ini, panggil metode IDataCollectorCollection::CreateDataCollector atau IDataCollectorCollection::CreateDataCollectorFromXml . Untuk detail tentang XML yang Anda berikan ke CreateDataCollectorFromXml, lihat Keterangan.

Warisan

Antarmuka ITraceDataCollector mewarisi dari antarmuka IDataCollector.

Metode

Antarmuka ITraceDataCollector memiliki metode ini.

ITraceDataCollector::get_BufferSize Mengambil atau mengatur ukuran buffer yang disarankan untuk setiap buffer dalam sesi pelacakan peristiwa. (Dapatkan)
ITraceDataCollector::get_BuffersLost Mengambil jumlah buffer yang tidak ditulis ke file log.
ITraceDataCollector::get_BuffersWritten Mengambil jumlah buffer yang ditulis ke file log.
ITraceDataCollector::get_ClockType Mengambil atau mengatur resolusi jam yang akan digunakan saat mencatat stempel waktu untuk setiap peristiwa. (Dapatkan)
ITraceDataCollector::get_EventsLost Mengambil jumlah peristiwa yang tidak ditulis ke buffer.
ITraceDataCollector::get_ExtendedModes Mengambil atau mengatur mode file log yang diperluas. (Dapatkan)
ITraceDataCollector::get_FlushTimer Mengambil atau mengatur waktu untuk menunggu sebelum membersihkan buffer. (Dapatkan)
ITraceDataCollector::get_FreeBuffers Mengambil jumlah buffer yang dialokasikan tetapi tidak digunakan dalam kumpulan buffer sesi pelacakan peristiwa.
ITraceDataCollector::get_Guid Mengambil atau mengatur GUID sesi. (Dapatkan)
ITraceDataCollector::get_IsKernelTrace Mengambil nilai yang menunjukkan apakah jejak berisi penyedia kernel.
ITraceDataCollector::get_MaximumBuffers Mengambil atau mengatur jumlah maksimum buffer yang dialokasikan untuk kumpulan buffer sesi pelacakan peristiwa. (Dapatkan)
ITraceDataCollector::get_MinimumBuffers Mengambil atau mengatur jumlah minimum buffer yang dialokasikan untuk kumpulan buffer sesi pelacakan peristiwa. (Dapatkan)
ITraceDataCollector::get_NumberOfBuffers Mengambil atau mengatur jumlah buffer yang disarankan untuk digunakan untuk pengelogan. (Dapatkan)
ITraceDataCollector::get_PreallocateFile Mengambil atau menetapkan nilai yang menunjukkan apakah PLA harus mengalokasikan seluruh ukuran file log sebelum pengelogan. (Dapatkan)
ITraceDataCollector::get_ProcessMode Mengambil atau menetapkan nilai yang menunjukkan apakah sesi tersebut adalah sesi privat dalam proses. (Dapatkan)
ITraceDataCollector::get_RealTimeBuffersLost Mengambil jumlah buffer yang tidak dikirimkan secara real time kepada konsumen.
ITraceDataCollector::get_SessionId Mengambil pengidentifikasi sesi.
ITraceDataCollector::get_SessionName Mengambil atau mengatur nama sesi. (Dapatkan)
ITraceDataCollector::get_SessionThreadId Mengambil utas sesi log saat ini, jika utas berjalan.
ITraceDataCollector::get_StreamMode Mengambil atau mengatur mode pengelogan sesi pelacakan. (Dapatkan)
ITraceDataCollector::get_TraceDataProviders Mengambil daftar penyedia yang diaktifkan untuk sesi pelacakan ini.
ITraceDataCollector::p ut_BufferSize Mengambil atau mengatur ukuran buffer yang disarankan untuk setiap buffer dalam sesi pelacakan peristiwa. (Put)
ITraceDataCollector::p ut_ClockType Mengambil atau mengatur resolusi jam yang akan digunakan saat mencatat stempel waktu untuk setiap peristiwa. (Put)
ITraceDataCollector::p ut_ExtendedModes Mengambil atau mengatur mode file log yang diperluas. (Put)
ITraceDataCollector::p ut_FlushTimer Mengambil atau mengatur waktu untuk menunggu sebelum membersihkan buffer. (Put)
ITraceDataCollector::p ut_Guid Mengambil atau mengatur GUID sesi. (Put)
ITraceDataCollector::p ut_MaximumBuffers Mengambil atau mengatur jumlah maksimum buffer yang dialokasikan untuk kumpulan buffer sesi pelacakan peristiwa. (Put)
ITraceDataCollector::p ut_MinimumBuffers Mengambil atau mengatur jumlah minimum buffer yang dialokasikan untuk kumpulan buffer sesi pelacakan peristiwa. (Put)
ITraceDataCollector::p ut_NumberOfBuffers Mengambil atau mengatur jumlah buffer yang disarankan untuk digunakan untuk pengelogan. (Put)
ITraceDataCollector::p ut_PreallocateFile Mengambil atau menetapkan nilai yang menunjukkan apakah PLA harus mengalokasikan seluruh ukuran file log sebelum pengelogan. (Put)
ITraceDataCollector::p ut_ProcessMode Mengambil atau menetapkan nilai yang menunjukkan apakah sesi tersebut adalah sesi privat dalam proses. (Put)
ITraceDataCollector::p ut_SessionName Mengambil atau mengatur nama sesi. (Put)
ITraceDataCollector::p ut_StreamMode Mengambil atau mengatur mode pengelogan sesi pelacakan. (Put)

Keterangan

Contoh berikut menunjukkan XML yang bisa Anda gunakan untuk menginisialisasi objek ini jika Anda memanggil metode IDataCollectorCollection::CreateDataCollectorFromXml untuk membuatnya. Properti IDataCollector::Xml juga mengembalikan XML ini.

<TraceDataCollector>
    <BufferSize/>
    <BuffersLost/>  <!-- Output only -->
    <BuffersWritten/>  <!-- Output only -->
    <ClockType/>
    <EventsLost/>  <!-- Output only -->
    <ExtendedMode/>
    <FlushTimer/>
    <FreeBuffers/>  <!-- Output only -->
    <Guid/>
    <IsKernelTrace/>
    <MaximumBuffers/>
    <MinimumBuffers/>
    <NumberOfBuffers/>
    <PreallocateFile/>
    <ProcessMode/>
    <RealTimeBuffersLost/>  <!-- Output only -->
    <SessionId/>  <!-- Output only -->
    <SessionName/>
    <SessionThreadId/>  <!-- Output only -->
    <StreamMode/>
    <TraceDataProvider>  <!-- Specify for each provider -->
        <DisplayName/>
        <FilterData/>
        <FilterType/>
        <Guid/>
        <KeywordsAll>
            <Description/>
            <ValueMapType/>
            <Value/>
        </KeywordsAll>
        <KeywordsAny>
            <Description/>
            <ValueMapType/>
            <Value/>
        <KeywordsAny/>
        <Level>
            <Description/>
            <ValueMapType/>
            <Value/>
        <Level/>
        <Properties/>
    </TraceDataProvider>
</TraceDataCollector>

Perhatikan bahwa contoh tidak menampilkan elemen properti yang diwarisi dari IDataCollector yang juga perlu Anda tentukan.

Saat Anda menentukan XML untuk membuat pengumpul, Anda hanya dapat menentukan elemen untuk properti yang ingin Anda atur. Jika Anda tidak menentukan properti, PLA menyediakan nilai default. Saat Anda mengambil XML untuk pengumpul, XML menyediakan semua elemen, termasuk yang berasal dari IDataCollector.

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	pla.h

Lihat juga

IDataCollector