Поделиться через


Интерфейс ITraceDataCollector (pla.h)

Собирает события трассировки от зарегистрированных поставщиков.

Этот интерфейс определяет сеанс трассировки. Сеанс запускается при запуске набора сборщиков данных. Коллекция поставщиков данных трассировки определяет поставщиков, которые необходимо включить в сеанс при запуске сеанса.

Чтобы создать этот сборщик данных, вызовите метод IDataCollectorCollection::CreateDataCollector или IDataCollectorCollection::CreateDataCollectorFromXml . Дополнительные сведения о XML-файле, передаваемом в CreateDataCollectorFromXml, см. в разделе Примечания.

Наследование

Интерфейс ITraceDataCollector наследуется от интерфейса IDataCollector.

Методы

Интерфейс ITraceDataCollector содержит следующие методы.

 
ITraceDataCollector::get_BufferSize

Извлекает или задает предлагаемый размер буфера для каждого буфера в сеансе трассировки событий. (Получить)
ITraceDataCollector::get_BuffersLost

Извлекает количество буферов, которые не были записаны в файл журнала.
ITraceDataCollector::get_BuffersWritten

Извлекает количество буферов, записанных в файл журнала.
ITraceDataCollector::get_ClockType

Получает или задает разрешение часов, используемое при регистрации метки времени для каждого события. (Получить)
ITraceDataCollector::get_EventsLost

Извлекает количество событий, которые не были записаны в буфер.
ITraceDataCollector::get_ExtendedModes

Извлекает или задает расширенные режимы файлов журнала. (Получить)
ITraceDataCollector::get_FlushTimer

Извлекает или задает время ожидания перед очисткой буферов. (Получить)
ITraceDataCollector::get_FreeBuffers

Извлекает количество буферов, выделенных, но не используемых в буферном пуле сеанса трассировки событий.
ITraceDataCollector::get_Guid

Извлекает или задает GUID сеанса. (Получить)
ITraceDataCollector::get_IsKernelTrace

Извлекает значение, указывающее, содержит ли трассировка поставщиков ядра.
ITraceDataCollector::get_MaximumBuffers

Извлекает или задает максимальное количество буферов, выделенных для буферного пула сеанса трассировки событий. (Получить)
ITraceDataCollector::get_MinimumBuffers

Извлекает или задает минимальное количество буферов, выделенных для буферного пула сеанса трассировки событий. (Получить)
ITraceDataCollector::get_NumberOfBuffers

Извлекает или задает предлагаемое количество буферов, используемых для ведения журнала. (Получить)
ITraceDataCollector::get_PreallocateFile

Получает или задает значение, указывающее, следует ли PLA выделить весь размер файла журнала перед ведением журнала. (Получить)
ITraceDataCollector::get_ProcessMode

Извлекает или задает значение, указывающее, является ли сеанс частным внутрипроцессным сеансом. (Получить)
ITraceDataCollector::get_RealTimeBuffersLost

Извлекает количество буферов, которые не были доставлены потребителю в режиме реального времени.
ITraceDataCollector::get_SessionId

Извлекает идентификатор сеанса.
ITraceDataCollector::get_SessionName

Получает или задает имя сеанса. (Получить)
ITraceDataCollector::get_SessionThreadId

Извлекает текущий поток сеанса журнала, если поток выполняется.
ITraceDataCollector::get_StreamMode

Получает или задает режим ведения журнала сеанса трассировки. (Получить)
ITraceDataCollector::get_TraceDataProviders

Извлекает список поставщиков, включенных для этого сеанса трассировки.
ITraceDataCollector::p ut_BufferSize

Извлекает или задает предлагаемый размер буфера для каждого буфера в сеансе трассировки событий. (Put)
ITraceDataCollector::p ut_ClockType

Получает или задает разрешение часов, используемое при регистрации метки времени для каждого события. (Put)
ITraceDataCollector::p ut_ExtendedModes

Извлекает или задает расширенные режимы файлов журнала. (Put)
ITraceDataCollector::p ut_FlushTimer

Извлекает или задает время ожидания перед очисткой буферов. (Put)
ITraceDataCollector::p ut_Guid

Извлекает или задает GUID сеанса. (Put)
ITraceDataCollector::p ut_MaximumBuffers

Извлекает или задает максимальное количество буферов, выделенных для буферного пула сеанса трассировки событий. (Put)
ITraceDataCollector::p ut_MinimumBuffers

Извлекает или задает минимальное количество буферов, выделенных для буферного пула сеанса трассировки событий. (Put)
ITraceDataCollector::p ut_NumberOfBuffers

Извлекает или задает предлагаемое количество буферов, используемых для ведения журнала. (Put)
ITraceDataCollector::p ut_PreallocateFile

Получает или задает значение, указывающее, следует ли PLA выделить весь размер файла журнала перед ведением журнала. (Put)
ITraceDataCollector::p ut_ProcessMode

Извлекает или задает значение, указывающее, является ли сеанс частным внутрипроцессным сеансом. (Put)
ITraceDataCollector::p ut_SessionName

Получает или задает имя сеанса. (Put)
ITraceDataCollector::p ut_StreamMode

Извлекает или задает режим ведения журнала сеанса трассировки. (Put)

Комментарии

В следующем примере показан XML-код, который можно использовать для инициализации этого объекта при вызове метода IDataCollectorCollection::CreateDataCollectorFromXml для его создания. Свойство IDataCollector::Xml также возвращает этот XML-код.

<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>

Обратите внимание, что в примере не показаны элементы свойств, унаследованные от IDataCollector , которые также необходимо указать.

При указании XML-кода для создания сборщика можно указать только элементы для свойств, которые требуется задать. Если свойство не указано, PLA предоставляет значение по умолчанию. При получении XML-кода для сборщика XML предоставляет все элементы, включая элементы из IDataCollector.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header pla.h

См. также раздел

IDataCollector