Jenis Kompleks Penyedia

Menentukan penyedia dan penghitung yang disediakannya.

<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>

Elemen anak

Elemen	Jenis	Deskripsi
counterSet	man:counterSet	Mengidentifikasi set penghitung yang berisi satu atau beberapa penghitung terkait logis.

Atribut

Nama	Jenis	Deskripsi
applicationIdentity	xs:string	Nama file biner yang berisi string sumber daya yang dilokalkan, baik file .exe atau .dll (jangan sertakan jalur ke biner). Utilitas Lodctr.exe menggunakan jalur dari parameter [jalur] opsional untuk mencari file biner. Misalnya, lodctr [/m:manifest [path]]. Jika Anda tidak menyertakan parameter [jalur], Lodctr.exe mencari folder yang berisi manifes.
panggilan balik	Atribut ini menunjukkan bahwa Anda ingin menerima pemberitahuan saat konsumen melakukan tindakan tertentu. Jika Anda menyertakan atribut ini, alat CTRPP menggunakan tanda tangan fungsi CounterInitialize alternatif, yang Anda gunakan untuk meneruskan nama fungsi Anda yang mengimplementasikan fungsi panggilan balik ControlCallback . Sebagai alternatif untuk menentukan atribut ini, Anda dapat menggunakan argumen -NotificationCallbackCTRPP . Windows Vista: Satu-satunya nilai yang valid untuk atribut ini adalah "kustom". Utilitas CTRPP menghasilkan templat untuk fungsi panggilan balik ControlCallback . Templat disertakan dalam file .c yang dihasilkan CTRPP.
providerGuid	man:GUIDType	STRING GUID yang secara unik mengidentifikasi penyedia dalam manifes. GUID harus unik dalam manifes. Anda perlu memberikan GUID baru hanya ketika versi aplikasi berubah (jika Anda mendukung penginstalan berdampingan).
providerName	xs:string	Nama yang digunakan untuk membuat nama kelas Win32_PerfRawData WMI. Jika Anda tidak menentukan nama, "Penghitung" digunakan sebagai nama kelas.
providerType	Mengidentifikasi apakah penyedia adalah penyedia mode pengguna, penyedia mode kernel, atau penyedia driver. Kemungkinan nilainya adalah sebagai berikut: Istilah Deskripsi userMode Tentukan mode ini untuk komponen mode pengguna seperti aplikasi, DLL, atau driver mode pengguna. Ekstensi umum untuk komponen mode pengguna .exe atau .dll. Ini adalah default. Kernel Tentukan mode ini untuk komponen mode kernel seperti driver WDM atau WDF. Ekstensi umum untuk komponen mode kernel adalah .sys. Windows Vista dan Windows Server 2008: Nilai ini tidak didukung sampai Windows 7 dan Windows Server 2008 R2.
resourceBase	man:UInt32Type	Menentukan nilai indeks sumber daya awal yang digunakan CTRPP untuk menghasilkan pengidentifikasi sumber daya.
simbol	man:CSymbolType	Nama simbolis yang mengidentifikasi penyedia. Alat CTRPP membuat variabel HANDLE yang dapat Anda gunakan saat memanggil fungsi yang memerlukan handel ke penyedia (misalnya, PerfSetULongCounterValue). Nama simbolis adalah nama variabel. Jika Anda menyertakan argumen -prefix saat memanggil CTRPP, string awalan ditambahkan ke awal nama simbolis.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]