Compartir a través de


provider Complex Type

Define un proveedor y los contadores que proporciona.

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

Elemento Tipo Descripción
counterSet man:counterSet Identifica el conjunto de contadores que contiene uno o varios contadores relacionados lógicamente.

Atributos

Nombre Tipo Descripción
applicationIdentity xs:string Nombre del archivo binario que contiene las cadenas de recursos localizadas, ya sea un archivo .exe o .dll (no incluya la ruta de acceso al archivo binario).
La utilidad Lodctr.exe usa la ruta de acceso del parámetro opcional [path] para buscar el archivo binario. Por ejemplo, lodctr [/m:manifest [path]]. Si no incluye el parámetro [path], Lodctr.exe busca en la carpeta que contiene el manifiesto.
devolución de llamada Este atributo indica que desea recibir notificaciones cuando un consumidor realiza determinadas acciones.
Si incluye este atributo, la herramienta CTRPP usa la firma de función CounterInitialize alternativa, que se usa para pasar el nombre de la función que implementa la función de devolución de llamada ControlCallback .
Como alternativa a especificar este atributo, puede usar el argumento CTRPP-NotificationCallback.
Windows Vista: El único valor válido para este atributo es "custom". La utilidad CTRPP genera la plantilla para una función de devolución de llamada ControlCallback . La plantilla se incluye en el archivo .c generado por CTRPP.

providerGuid man:GUIDType GUID de cadena que identifica de forma única el proveedor en el manifiesto. El GUID debe ser único dentro del manifiesto.
Solo debe proporcionar un nuevo GUID cuando cambie la versión de la aplicación (si admite instalaciones en paralelo).
providerName xs:string Nombre que se usa para crear el nombre de clase Win32_PerfRawData WMI. Si no especifica un nombre, se usa "Counters" como nombre de la clase .
providerType Identifica si el proveedor es un proveedor en modo de usuario, proveedor de modo kernel o proveedor de controladores. Los valores posibles son los siguientes.
Término Descripción
userMode
Especifique este modo para un componente en modo de usuario, como una aplicación, un archivo DLL o un controlador en modo de usuario. Las extensiones típicas de los componentes en modo de usuario son .exe o .dll. Este es el valor predeterminado.
Núcleo
Especifique este modo para un componente en modo kernel, como un controlador WDM o WDF. La extensión típica para los componentes en modo kernel es .sys.
Windows Vista y Windows Server 2008: Este valor no se admite hasta Windows 7 y Windows Server 2008 R2.

resourceBase man:UInt32Type

Define el valor de índice de recursos inicial que CTRPP usa para generar los identificadores de recursos.

símbolo man:CSymbolType

Nombre simbólico que identifica el proveedor. La herramienta CTRPP crea una variable HANDLE que puede usar al llamar a funciones que requieren un identificador para el proveedor (por ejemplo, PerfSetULongCounterValue). El nombre simbólico es el nombre de la variable.

Si incluye el argumento -prefix al llamar a CTRPP, la cadena de prefijo se agrega al principio del nombre simbólico.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2008 [solo aplicaciones de escritorio]