提供者複雜類型

定義提供者及其提供的計數器。

<xs:complexType name="provider">
    <xs:choice
        minOccurs="0"
        maxOccurs="unbounded"
    >
        <xs:element name="counterSet"
            type="man:counterSet"
        >
            <xs:key name="uniqueCounterID">
                <xs:selector
                    xpath="./man:counter"
                 />
                <xs:field
                    xpath="@id"
                 />
            </xs:key>
            <xs:unique name="uniqueCounterName">
                <xs:selector
                    xpath="./man:counter"
                 />
                <xs:field
                    xpath="@name"
                 />
            </xs:unique>
            <xs:keyref name="existBaseID">
                <xs:selector
                    xpath="./man:counter"
                 />
                <xs:field
                    xpath="@baseID"
                 />
            </xs:keyref>
            <xs:keyref name="existPerfTimeID">
                <xs:selector
                    xpath="./man:counter"
                 />
                <xs:field
                    xpath="@perfTimeID"
                 />
            </xs:keyref>
            <xs:keyref name="existPerfFreqID">
                <xs:selector
                    xpath="./man:counter"
                 />
                <xs:field
                    xpath="@perfFreqID"
                 />
            </xs:keyref>
            <xs:keyref name="existMultiCounterID">
                <xs:selector
                    xpath="./man:counter"
                 />
                <xs:field
                    xpath="@multiCounterID"
                 />
            </xs:keyref>
            <xs:key name="uniqueStructNames">
                <xs:selector
                    xpath="./man:structs/man:struct"
                 />
                <xs:field
                    xpath="@name"
                 />
            </xs:key>
            <xs:keyref name="existCounterName">
                <xs:selector
                    xpath="./man:counter"
                 />
                <xs:field
                    xpath="@struct"
                 />
            </xs:keyref>
        </xs:element>
    </xs:choice>
    <xs:attribute name="symbol"
        type="man:CSymbolType"
        use="optional"
     />
    <xs:attribute name="callback"
        use="optional"
        default="default"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:string"
            >
                <xs:enumeration
                    value="custom"
                 />
                <xs:enumeration
                    value="default"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="providerGuid"
        type="man:GUIDType"
        use="required"
     />
    <xs:attribute name="applicationIdentity"
        type="xs:string"
        use="required"
     />
    <xs:attribute name="providerType"
        use="optional"
        default="userMode"
    >
        <xs:simpleType>
            <xs:restriction
                base="xs:string"
            >
                <xs:enumeration
                    value="userMode"
                 />
                <xs:enumeration
                    value="kernelMode"
                 />
            </xs:restriction>
        </xs:simpleType>
    </xs:attribute>
    <xs:attribute name="providerName"
        type="xs:string"
        use="optional"
        default="Counters"
     />
    <xs:attribute name="resourceBase"
        type="man:UInt32Type"
        use="optional"
     />
</xs:complexType>

子元素

元素	類型	Description
counterSet	man：counterSet	識別包含一或多個邏輯相關計數器的計數器集。

屬性

名称	類型	Description
applicationIdentity	xs:string	包含當地語系化資源字串的二進位檔名稱，.exe或.dll (檔案的名稱不包含二進位) 的路徑。 Lodctr.exe公用程式會使用選擇性 [path] 參數的路徑來搜尋二進位檔案。 例如， lodctr [/m：manifest [path]]。 如果您沒有包含 [path] 參數，Lodctr.exe搜尋包含資訊清單的資料夾。
回撥	此屬性工作表示當取用者執行特定動作時，您想要接收通知。 如果您包含這個屬性，CTRPP 工具會使用替代 CounterInitialize 函式簽章，用來傳入實作 ControlCallback 回 呼函式的函式名稱。 除了指定此屬性，您也可以使用 -NotificationCallbackCTRPP 引數。 Windows Vista： 此屬性的唯一有效值為 「custom」。 CTRPP公用程式會產生ControlCallback 回呼函式的範本。 範本包含在 CTRPP 產生的 .c 檔案中。
providerGuid	man：GUIDType	可唯一識別資訊清單中提供者的字串 GUID。 GUID 在資訊清單內必須是唯一的。 只有在應用程式版本變更 (支援並存安裝) 時，才需要提供新的 GUID。
providerName	xs:string	用來建立 WMI Win32_PerfRawData類別名稱的名稱。 如果您未指定名稱，則會使用 「Counters」 做為類別的名稱。
providerType	識別提供者是否為使用者模式提供者、核心模式提供者或驅動程式提供者。 可能的值如下。 詞彙 描述 userMode 為使用者模式元件指定此模式，例如應用程式、DLL 或使用者模式驅動程式。 使用者模式元件的一般擴充功能是.exe或.dll。 此為預設值。 內核 針對核心模式元件指定此模式，例如 WDM 或 WDF 驅動程式。 核心模式元件的典型延伸模組是.sys。 Windows Vista 和 Windows Server 2008： 在 Windows 7 和 Windows Server 2008 R2 之前，不支援此值。
resourceBase	man：UInt32Type	定義 CTRPP 用來產生資源識別碼的起始資源索引值。
符號	man：CSymbolType	識別提供者的符號名稱。 CTRPP工具會建立 HANDLE 變數，您可以在呼叫需要 (提供者控制碼的函式時使用，例如PerfSetULongCounterValue) 。 符號名稱是變數的名稱。 如果您在呼叫CTRPP時包含-prefix引數，則會將前置詞字串新增至符號名稱的開頭。

規格需求

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