공급자 복합 형식

공급자 및 공급자가 제공 하는 카운터를 정의 합니다.

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

자식 요소

요소 유형 Description
counterSet man: counterSet 논리적으로 관련 된 하나 이상의 카운터를 포함 하는 카운터 집합을 식별 합니다.

특성

이름 유형 Description
applicationIdentity xs:string 지역화 된 리소스 문자열 (.exe 또는 .dll 파일)을 포함 하는 이진 파일의 이름입니다 (이진에 대 한 경로 포함 안 함).
Lodctr.exe 유틸리티는 선택적 [path] 매개 변수의 경로를 사용 하 여 이진 파일을 검색 합니다. 예: lodctr [/m:manifest [path]]. [Path] 매개 변수를 포함 하지 않으면 Lodctr.exe 매니페스트가 포함 된 폴더를 검색 합니다.
콜백(callback) 이 특성은 소비자가 특정 작업을 수행할 때 알림을 받도록 지정 합니다.
이 특성을 포함 하는 경우 CTRPP 도구는 controlcallback 콜백 함수를 구현 하는 함수 이름을 전달 하는 데 사용 하는 대체 counterinitialize 함수 시그니처를 사용 합니다.
이 특성을 지정 하는 대신 -notificationcallbackctrpp 인수를 사용할 수 있습니다.
Windows Vista: 이 특성에 대해 유일 하 게 유효한 값은 " custom " 입니다. Ctrpp 유틸리티는 controlcallback 콜백 함수에 대 한 템플릿을 생성 합니다. 템플릿은 CTRPP가 생성 한 .c 파일에 포함 되어 있습니다.

providerGuid man: GUIDType 매니페스트에서 공급자를 고유 하 게 식별 하는 문자열 GUID입니다. GUID는 매니페스트 내에서 고유 해야 합니다.
응용 프로그램의 버전이 변경 될 때만 새 GUID를 제공 해야 합니다 (side-by-side 설치를 지 원하는 경우).
providerName xs:string WMI Win32_PerfRawData 클래스 이름을 만드는 데 사용 되는 이름입니다. 이름을 지정 하지 않으면 " 카운터 " 는 클래스 이름으로 사용 됩니다.
providerType 공급자가 사용자 모드 공급자, 커널 모드 공급자 또는 드라이버 공급자 인지 여부를 식별 합니다. 가능한 값은 다음과 같습니다.
용어 Description
userMode
응용 프로그램, DLL 또는 사용자 모드 드라이버와 같은 사용자 모드 구성 요소에 대해이 모드를 지정 합니다. 사용자 모드 구성 요소에 대 한 일반적인 확장은 .exe 또는 .dll입니다. 이것이 기본값입니다.
kernel
WDM 또는 WDF 드라이버와 같은 커널 모드 구성 요소에 대해이 모드를 지정 합니다. 커널 모드 구성 요소에 대 한 일반적인 확장은 .sys입니다.
Windows Vista 및 Windows Server 2008: 이 값은 Windows 7 및 Windows Server 2008 R2까지 지원 되지 않습니다.

resourceBase man: UInt32Type

Ctrpp 에서 리소스 식별자를 생성 하는 데 사용 하는 시작 리소스 인덱스 값을 정의 합니다.

기호 man: C기호 형식

공급자를 식별 하는 기호화 된 이름입니다. Ctrpp 도구는 공급자 (예: PerfSetULongCounterValue)에 대 한 핸들이 필요한 함수를 호출할 때 사용할 수 있는 핸들 변수를 만듭니다. 기호화 된 이름은 변수의 이름입니다.

Ctrpp를 호출할 때 -prefix 인수를 포함 하는 경우 접두사 문자열이 기호화 된 이름의 시작 부분에 추가 됩니다.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows Vista [ 데스크톱 앱에만 해당]
지원되는 최소 서버
Windows Server 2008 [ 데스크톱 앱에만 해당]