Freigeben über

komplexer Anbietertyp

  • Artikel

Definiert einen Anbieter und die leistungsindikatoren, die er bereitstellt.

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

Untergeordnete Elemente

Element type Beschreibung
Counterset man:counterSet Gibt den Zählersatz an, der einen oder mehrere logisch verwandte Indikatoren enthält.

Attributes

Name type Beschreibung
Applicationidentity xs:string Der Name der Binärdatei, die die lokalisierten Ressourcenzeichenfolgen enthält, entweder eine .exe- oder .dll datei (den Pfad zur Binärdatei nicht enthalten).
Das Hilfsprogramm Lodctr.exe verwendet den Pfad aus dem optionalen [path]-Parameter, um nach der Binärdatei zu suchen. Beispiel: lodctr [/m:manifest [path]]. Wenn Sie den Parameter [path] nicht einschließen, durchsucht Lodctr.exe den Ordner, der das Manifest enthält.
Rückruf Dieses Attribut gibt an, dass Sie eine Benachrichtigung erhalten möchten, wenn ein Consumer bestimmte Aktionen ausführt.
Wenn Sie dieses Attribut einschließen, verwendet das CTRPP-Tool die alternative CounterInitialize-Funktionssignatur , die Sie verwenden, um den Namen Ihrer Funktion zu übergeben, die die ControlCallback-Rückruffunktion implementiert.
Alternativ zur Angabe dieses Attributs können Sie das CTRPP-Argument-NotificationCallback verwenden.
Windows Vista: Der einzige gültige Wert für dieses Attribut ist "custom". Das CTRPP-Hilfsprogramm generiert die Vorlage für eine ControlCallback-Rückruffunktion . Die Vorlage ist in der VON CTRPP generierten C-Datei enthalten.

providerGuid man:GUIDType Zeichenfolgen-GUID, die den Anbieter im Manifest eindeutig identifiziert. Die GUID muss innerhalb des Manifests eindeutig sein.
Sie müssen eine neue GUID nur bereitstellen, wenn sich die Version der Anwendung ändert (wenn Sie parallele Installationen unterstützen).
providerName xs:string Der Name, der zum Erstellen des WMI-Win32_PerfRawData Klassennamens verwendet wird. Wenn Sie keinen Namen angeben, wird "Counters" als Name der Klasse verwendet.
Providertype Gibt an, ob der Anbieter ein Benutzermodusanbieter, Kernelmodusanbieter oder Treiberanbieter ist. Die folgenden Werte sind möglich.
Begriff Beschreibung
Usermode
 Geben Sie diesen Modus für eine Komponente im Benutzermodus an, z. B. eine Anwendung, eine DLL oder einen Benutzermodustreiber. Die typischen Erweiterungen für Benutzermoduskomponenten sind .exe oder .dll. Dies ist die Standardeinstellung.
Kernel
 Geben Sie diesen Modus für eine Kernelmoduskomponente wie einen WDM- oder WDF-Treiber an. Die typische Erweiterung für Kernelmoduskomponenten ist .sys.
Windows Vista und Windows Server 2008: Dieser Wert wird erst unter Windows 7 und Windows Server 2008 R2 unterstützt.

resourceBase man:UInt32Type

Definiert den Startressourcenindexwert, den CTRPP zum Generieren der Ressourcenbezeichner verwendet.
Symbol man:CSymbolType

Ein symbolischer Name, der den Anbieter identifiziert. Das CTRPP-Tool erstellt eine HANDLE-Variable, die Sie verwenden können, wenn Sie Funktionen aufrufen, die ein Handle für den Anbieter erfordern (z. B. PerfSetULongCounterValue). Der symbolische Name ist der Name der Variablen.

Wenn Sie beim Aufrufen von CTRPP das Argument -prefix einschließen, wird die Präfixzeichenfolge am Anfang des symbolischen Namens hinzugefügt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2008 [nur Desktop-Apps]