Tipo complesso provider

Definisce un provider e i contatori che fornisce.

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

Elementi figlio

Elemento Tipo Descrizione
counterSet uomo: contatore Identifica l'insieme di contatori che contiene uno o più contatori correlati logicamente.

Attributi

Nome Tipo Descrizione
applicationIdentity xs:string Nome del file binario che contiene le stringhe di risorsa localizzate, ovvero un file con estensione exe o dll (non includere il percorso del file binario).
L'utilità Lodctr.exe usa il percorso dal parametro facoltativo [path] per cercare il file binario. Ad esempio, lodctr [/m:manifest [path]]. Se non si include il parametro [path], Lodctr.exe Cerca nella cartella che contiene il manifesto.
callback Questo attributo indica che si desidera ricevere una notifica quando un consumer esegue determinate azioni.
Se si include questo attributo, lo strumento CTRPP usa la firma della funzione CounterInitialize alternativa, che viene usata per passare il nome della funzione che implementa la funzione di callback ControlCallback .
In alternativa alla specifica di questo attributo, è possibile usare l'argomento -NotificationCallbackCTRPP .
Windows Vista: L'unico valore valido per questo attributo è " Custom " . L'utilità CTRPP genera il modello per una funzione di callback ControlCallback . Il modello è incluso nel file con estensione c generato da CTRPP.

providerGuid uomo: GUIDType GUID di stringa che identifica in modo univoco il provider nel manifesto. Il GUID deve essere univoco all'interno del manifesto.
È necessario fornire un nuovo GUID solo quando cambia la versione dell'applicazione (se si supportano installazioni affiancate).
providerName xs:string Nome utilizzato per creare il nome della classe WMI Win32_PerfRawData. Se non si specifica un nome, i " contatori " vengono usati come nome della classe.
providerType Indica se il provider è un provider in modalità utente, un provider in modalità kernel o un provider di driver. I valori possibili sono i seguenti.
Termine Descrizione
userMode
Specificare questa modalità per un componente in modalità utente, ad esempio un'applicazione, una DLL o un driver in modalità utente. Le estensioni tipiche per i componenti in modalità utente sono exe o dll. Questo è il valore predefinito.
kernel
Specificare questa modalità per un componente in modalità kernel, ad esempio un driver WDM o CDR. L'estensione tipica per i componenti in modalità kernel è. sys.
Windows Vista e Windows Server 2008: Questo valore non è supportato fino a Windows 7 e Windows Server 2008 R2.

resourceBase uomo: UInt32Type

Definisce il valore di indice della risorsa iniziale utilizzato da CTRPP per generare gli identificatori di risorsa.

simbolo uomo: CSymbolType

Nome simbolico che identifica il provider. Lo strumento CTRPP crea una variabile handle che è possibile usare quando si chiamano funzioni che richiedono un handle per il provider (ad esempio, PerfSetULongCounterValue). Il nome simbolico è il nome della variabile.

Se si include l'argomento -Prefix quando si chiama CTRPP, la stringa di prefisso viene aggiunta all'inizio del nome simbolico.

Requisiti

Requisito Valore
Client minimo supportato
[Solo app desktop di Windows Vista]
Server minimo supportato
[Solo app desktop Windows Server 2008]