Partilhar via

tipo complexo do provedor

  • Artigo

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 localizadas, 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 [caminho] opcional para pesquisar o arquivo binário. Por exemplo, lodctr [/m:manifest [path]]. 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 notificação quando um consumidor executa determinadas ações.
Se você incluir esse atributo, a ferramenta CTRPP usará a assinatura alternativa da função CounterInitialize , que você usa para passar o nome da função que implementa a função de retorno de chamada ControlCallback .
Como alternativa à especificação desse 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 está incluído no arquivo .c gerado pelo CTRPP.

providerGuid man:GUIDType GUID de cadeia de caracteres que identifica exclusivamente o provedor no manifesto. O GUID deve ser exclusivo dentro do 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 nome da classe Win32_PerfRawData WMI. Se você não especificar um nome, "Contadores" será usado 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
Usermode
 Especifique esse modo para um componente do modo de usuário, como um aplicativo, uma DLL ou um driver de modo de usuário. As extensões típicas para 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 CTRPP usa para gerar os identificadores de recurso.
símbolo man:CSymbolType

Um nome simbólico que identifica o provedor. A ferramenta CTRPP cria uma variável HANDLE 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
 Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2008 [somente aplicativos da área de trabalho]