Tipo complexo do provedor

Define um provedor e os contadores que ele fornece.

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

Elementos filho

Elemento Type Descrição
counterSet Man: CounterSet Identifica o conjunto de contadores que contém um ou mais contadores logicamente relacionados.

Atributos

Nome Tipo Descrição
applicationIdentity xs:string O nome do arquivo binário que contém as cadeias de caracteres de recurso localizado, um arquivo. exe ou. dll (não inclua o caminho para o binário).
O utilitário Lodctr.exe usa o caminho do parâmetro opcional [path] para pesquisar o arquivo binário. Por exemplo, lodctr [/m:manifest [caminho]]. Se você não incluir o parâmetro [path], Lodctr.exe pesquisará a pasta que contém o manifesto.
retorno de chamada Esse atributo indica que você deseja receber a notificação quando um consumidor executa determinadas ações.
Se você incluir esse atributo, a ferramenta CTRPP usará a assinatura de função myinitialize alternativa, que você usará para passar o nome da função que implementa a função de retorno de chamada ControlCallback .
Como alternativa para especificar esse atributo, você pode usar o argumento -NotificationCallbackctrpp .
Windows Vista: O único valor válido para esse atributo é " personalizado " . O utilitário ctrpp gera o modelo para uma função de retorno de chamada ControlCallback . O modelo é incluído no arquivo. c que CTRPP gerou.

providerGuid Man: GUIDtype GUID de cadeia de caracteres que identifica exclusivamente o provedor no manifesto. O GUID deve ser exclusivo no manifesto.
Você precisa fornecer um novo GUID somente quando a versão do aplicativo for alterada (se você oferecer suporte a instalações lado a lado).
providerName xs:string O nome usado para criar o WMI Win32_PerfRawData nome da classe. Se você não especificar um nome, " os contadores " serão usados como o nome da classe.
providerType Identifica se o provedor é um provedor de modo de usuário, provedor de modo kernel ou provedor de driver. Os valores possíveis são os seguintes.
Termo Descrição
Modo
Especifique esse modo para um componente de modo de usuário, como um aplicativo, uma DLL ou um driver de modo de usuário. As extensões típicas para os componentes do modo de usuário são. exe ou. dll. Esse é o padrão.
kernel
Especifique esse modo para um componente do modo kernel, como um driver WDM ou WDF. A extensão típica para componentes do modo kernel é. sys.
Windows Vista e Windows Server 2008: Esse valor não tem suporte até o Windows 7 e o Windows Server 2008 R2.

resourceBase Man: UInt32type

Define o valor de índice de recurso inicial que o ctrpp usa para gerar os identificadores de recurso.

símbolo homem: CSymbolType

Um nome simbólico que identifica o provedor. A ferramenta ctrpp cria uma variável de identificador que você pode usar ao chamar funções que exigem um identificador para o provedor (por exemplo, PerfSetULongCounterValue). O nome simbólico é o nome da variável.

Se você incluir o argumento -prefix ao chamar ctrpp, a cadeia de caracteres de prefixo será adicionada ao início do nome simbólico.

Requisitos

Requisito Valor
Cliente mínimo com suporte
[Somente aplicativos da área de trabalho do Windows Vista]
Servidor mínimo com suporte
[Somente aplicativos da área de trabalho do Windows Server 2008]