pla.h (ITraceDataCollector 介面)

從已註冊的提供者收集追蹤事件。

此介面會定義追蹤會話。 當數據收集器集合執行時，會話就會啟動。 追蹤數據提供者的集合會定義您想要在會話執行時啟用至會話的提供者。

若要建立此數據收集器，請呼叫 IDataCollectorCollection：：CreateDataCollector 或 IDataCollectorCollection：：CreateDataCollectorFromXml 方法。 如需您傳遞至 CreateDataCollectorFromXml 之 XML 的詳細資訊，請參閱。

繼承

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)

備註

如果您呼叫 IDataCollectorCollection：：CreateDataCollectorFromXml 方法來建立它，下列範例會顯示可用來初始化這個物件的 XML。 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
標頭	pla.h

另請參閱

IDataCollector