共用方式為

counterSet 複雜類型

  • 發行項

定義邏輯相關計數器的清單。

<xs:complexType name="counterSet">
    <xs:sequence>
        <xs:element name="structs"
            type="man:structs"
            minOccurs="0"
            maxOccurs="1"
         />
        <xs:element name="counter"
            type="man:counter"
            minOccurs="1"
            maxOccurs="unbounded"
         />
    </xs:sequence>
    <xs:attribute name="symbol"
        type="man:CSymbolType"
        use="required"
     />
    <xs:attribute name="guid"
        type="man:GUIDType"
        use="required"
     />
    <xs:attribute name="uri"
        type="xs:anyURI"
        use="required"
     />
    <xs:attribute name="name"
        use="required"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:string"
            >
                <xs:maxLength
                    value="1023"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="description"
        type="xs:string"
        use="required"
     />
    <xs:attribute name="instances"
        use="optional"
        default="single"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:string"
            >
                <xs:enumeration
                    value="single"
                 />
                <xs:enumeration
                    value="multiple"
                 />
                <xs:enumeration
                    value="globalAggregate"
                 />
                <xs:enumeration
                    value="multipleAggregate"
                 />
                <xs:enumeration
                    value="globalAggregateHistory"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
</xs:complexType>

子元素

元素 類型 描述
計數器 man：counter 定義提供者提供的計數器。
結構 man：structs 結構專案清單，其中包含這個計數器集合中定義的計數器值。

屬性

名称 類型 描述
description xs:string 計數器集的簡短描述。
guid man：GUIDType 可唯一識別計數器集的 GUID。 如果 GUID 已註冊，計數器集注冊就會失敗。 若要更新已註冊的計數器集合，您必須先卸載計數器集合，然後再註冊一次。
執行個體 判斷計數器集合是否可以包含多個實例。 下列列出可能的值：
單
定義計數器集合，其中計數器集合中只能有一個計數器實例存在。 如果計數器提供全系統測量，例如實體記憶體，請指定此值。 此為預設值。
多個
定義計數器集合，其中計數器集合中的多個計數器實例可以存在。 如果計數器提供每個實例度量，例如每個進程的處理器時間，請指定此值。
globalAggregate
定義單一實例計數器集合，其中計數器集合中的計數器必須從各種作用中來源匯總。 例如，您可以建立一個計數器集，其中包含計算硬碟的磁片讀取數目的計數器。 如果電腦有三個硬碟，且取用者會查詢磁片讀取數目，PERFLIB 會取得每個磁片的讀取數目，並加總其個別值。
multipleAggregate
定義多個實例計數器集合，其中計數器集合中的計數器必須匯總到該計數器的所有實例。 例如，您可以建立多執行緒應用程式的計數器集，其中包含測量執行緒效能的計數器， (每個執行緒都會參考計數器集的實例) 。 當取用者查詢執行緒執行時間計數器總計時，PERFLIB 會加總每個實例的匯流排程執行時間。
globalAggregateHistory
定義單一實例計數器集合，其計數器值會在取用者的存留期內快取。 請注意，計數器集合中的所有計數器都會快取。 若要只快取特定計數器，請使用歷程記錄屬性裝飾這些計數器。
使用 globalAggregate 的磁片讀取範例，將會快取計數器集合中的所有計數器值。 如果一個磁片無法使用，該磁片所讀取之位元組總數的最後一個快取值仍可供取用者應用程式使用。
NAME 計數器集的顯示名稱。 必須小於 1，024 個字元。 名稱會區分大小寫。
符號 man：CSymbolType 識別計數器集的符號名稱。 CTRPP工具會建立 GUID 變數，您可以在呼叫需要計數器設定 GUID (的函式時使用，例如PerfCreateInstance) 。 變數名稱的格式為 符號名稱Guid。
如果您在呼叫CTRPP時包含-prefix引數，則會將前置詞字串新增至符號名稱的開頭。
uri xs:anyURI 唯一的統一資源識別項，可讓使用者從任何位置存取計數器集合中的計數器。

規格需求

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