Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Собирает события трассировки от зарегистрированных поставщиков.
Этот интерфейс определяет сеанс трассировки. Сеанс запускается при запуске набора сборщиков данных. Коллекция поставщиков данных трассировки определяет поставщиков, которые необходимо включить в сеанс при запуске сеанса.
Чтобы создать этот сборщик данных, вызовите метод 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 |