ChannelPublishingType 複雜類型

定義通道所使用的會話記錄屬性。

<xs:complexType name="ChannelPublishingType">
    <xs:sequence
        minOccurs="0"
    >
        <xs:element name="level"
            type="UInt8Type"
            default="0"
            minOccurs="0"
         />
        <xs:element name="keywords"
            type="UInt64Type"
            default="0"
            minOccurs="0"
         />
        <xs:element name="controlGuid"
            type="GUIDType"
            minOccurs="0"
         />
        <xs:element name="bufferSize"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="minBuffers"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="fileMax"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="maxBuffers"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="latency"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="clockType"
            default="SystemTime"
            minOccurs="0"
        >
            <xs:simpleType>
                <xs:restriction
                    base="xs:string"
                >
                    <xs:enumeration
                        value="SystemTime"
                     />
                    <xs:enumeration
                        value="QPC"
                     />
                </xs:restriction>
            </xs:simpleType>
        </xs:element>
        <xs:element name="sidType"
            minOccurs="0"
        >
            <xs:simpleType>
                <xs:restriction
                    base="xs:string"
                >
                    <xs:enumeration
                        value="None"
                     />
                    <xs:enumeration
                        value="Publishing"
                     />
                </xs:restriction>
            </xs:simpleType>
        </xs:element>
        <xs:any
            processContents="lax"
            minOccurs="0"
            maxOccurs="unbounded"
            namespace="##other"
         />
    </xs:sequence>
    <xs:anyAttribute
        processContents="lax"
        namespace="##other"
     />
</xs:complexType>

子元素

元素	類型	描述
bufferSize	UInt32Type	要配置給每個緩衝區的記憶體數量，以 KB 為單位。 如果您預期事件速率相對較低，緩衝區大小應設定為記憶體頁面大小。 如果事件速率預期相對較高，您應該指定較大的緩衝區大小，並增加緩衝區數目上限。 緩衝區大小會影響緩衝區填滿且必須排清的速率。 雖然小型緩衝區大小需要較少的記憶體，但它會增加必須排清緩衝區的速率。 分析和偵錯通道的預設緩衝區大小為 4 KB，管理員且操作為 64 KB。
clockType		記錄每個事件的時間戳記時所使用的時鐘解析。 您可以指定 SystemTime 或 QPC。 SystemTime 提供低解析度 (10 毫秒) 時間戳記，但比擷取成本較低。 預設值為 SystemTime。 查詢效能計數器 (QPC) 提供高解析度 (100 奈秒) 時間戳記，但比擷取成本更高。 如果您有高事件率，或取用者合併來自不同緩衝區的事件，則應該 QPC。
controlGuid	GUIDType	識別包含 WPP 事件的 ETW 會話的會話 GUID。 只有偵錯類型的通道才允許此設定。 這些通道無法完全啟用，關鍵字設定為零 (0x0000000000000000) 。 必須啟用關鍵字設定為 0xffffffffffffffff。
fileMax	UInt32Type	當啟用通道時，您希望服務建立新記錄檔的次數上限， (包括重新開機電腦時) 。 如果值為 0 或 1，服務會在每次啟用通道且先前的事件遺失時覆寫記錄檔。 如果值大於 1，服務會在每次啟用通道時建立新的記錄檔，以保留事件。 預設值為 1，而您可以指定的最大值為 16。 服務會將介於 0 和 fileMax 1 之間的三位數十進位數附加至每個檔案名。 例如， filename.etl.xxx，其中 xxx 是三位數十進位數。 這些檔案位於 %windir%\System32\winevt\Logs 中。
關鍵 字	UInt64Type	位元遮罩，決定寫入通道的事件類別。 如果 keywords 屬性的值是 0，則提供者寫入的所有事件都會寫入通道;否則，只有已定義 關鍵字 內含關鍵字的事件才會寫入通道。 預設值是 0。 已設定 controlGuid 屬性的偵錯通道必須將 關鍵字 屬性設定為 0xFFFFFFFFFFFFFFFF。 會話會在啟用提供者時，將關鍵字值傳遞至提供者。
延遲	UInt32Type	排清緩衝區之前要等候的時間，以毫秒為單位。 如果為零，ETW 會在緩衝區滿時立即排清。 如果為非零，ETW 會根據值排清包含事件的所有緩衝區，即使緩衝區未滿也一樣。 一般而言，只有在緩衝區已滿時，才想要排清緩衝區。 強制緩衝區排清可能會增加記錄檔的檔案大小與未填滿的緩衝區空間。 管理員和作業記錄的預設值為 1 秒，分析和偵錯記錄的預設值為 5 秒。
水準	UInt8Type	要寫入通道的事件嚴重性層級。 服務會將事件寫入通道，其層級值小於或等於指定的值。 預設值為 0，這表示使用任何層級值記錄事件。 會話會在啟用提供者時，將層級值傳遞至提供者。
maxBuffers	UInt32Type	要配置給會話的緩衝區數目上限。 一般而言，此值是緩衝區數目下限加上 20。 這個值必須大於或等於 minBuffers 所指定的值。 分析和偵錯通道的預設緩衝區數目上限為 10 KB，管理員且作業為 64 KB。
minBuffers	UInt32Type	要配置給會話的緩衝區數目下限。 預設值是零。
sidType		判斷是否要在主體) 中包含安全性識別碼 (SID，以及寫入通道的每個事件。 若要包含 SID 與 事件，請將此屬性設定為 「Publishing」。 SID 會根據寫入事件時的執行緒身分識別來設定。 如果您不想將 SID 與 事件一起納入，請將此屬性設定為 「None」。 預設值為 「Publishing」。

備註

您可以針對分析和偵錯通道類型，或任何指定自訂隔離的通道指定此發佈資訊。

雖然您可以指定層級和關鍵字，但您應該考慮這些是您從該通道的提供者收到的唯一事件。

當緩衝區已滿時，ETW 會將緩衝區排清到記錄檔。 如果緩衝區的填滿速度比可以排清快，則會配置新的緩衝區並新增至會話的緩衝集區，最多指定數目。 超過此限制，會話會捨棄傳入事件，直到緩衝區變成可用為止。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]