Partager via


provider Element

Use the provider element to group one or more counter sets that the provider provides.

Usage

<provider
  symbol = "String"
  providerGuid = "GUID"
  callback = "String"
  applicationIdentity = "String"
  providerType = "String"
  providerName = "String"
  resourceBase = "Integer"
>
  child elements
</provider>

Attributes

Attribute Type Required Description

applicationIdentity

String

Yes

Name of the binary file that contains the localized resource strings, either an .exe or .dll file (do not include the path to the binary).

The Lodctr.exe utility uses the path from the optional [path] parameter to search for the binary file. For example, lodctr [/m:manifest [path]]. If you do not include the [path] parameter, Lodctr.exe searches the folder that contains the manifest.

callback

String

No

Indicates that you want to receive notification when a consumer performs certian actions. The only valid value for this attribute is "custom".

If you include this attribute, the CTRPP tool uses the alternate CounterInitialize function signature, which you use to pass in the name of your function that implements the ControlCallback callback function.

As an alternative to specifying this attribute, you can use the -NotificationCallbackCTRPP argument.

Windows Vista:  The CTRPP utility generates the template for a ControlCallback callback function. The template is included in the .c file that CTRPP generated.

providerGuid

GUID

Yes

String GUID used to uniquely identify the provider in the manifest. The GUID must be unique within the manifest.

You only need to provide a new GUID when the version of the application changes if you support side-by-side installations.

providerName

String

No

Name that is used to create the WMI Win32_PerfRawData class name. If you do not specify a name, "Counters" is used as the name of the class.

providerType

String

No

Identifies whether the provider is a user-mode provider, kernel-mode provider, or driver provider.

Possible values include:

userMode

Specify this mode for a user-mode component such as an application, a DLL, or a user-mode driver. The typical extensions for user-mode components are .exe or .dll. This is the default.

kernel

Specify this mode for a kernel-mode component such as a WDM or WDF driver. The typical extension for kernel-mode components is .sys.

Windows Vista and Windows Server 2008:  Not supported.

driver

Not supported.

resourceBase

Integer

No

Defines the starting resource index value that CTRPP uses when generating the resource identifiers.

symbol

String

Yes

A symbolic name that identifies the provider. The CTRPP tool creates a HANDLE variable that you can use when calling functions that require a handle to the provider (for example, PerfSetULongCounterValue). The symbolic name is the name of the variable.

If you include the -prefix argument when calling CTRPP, the prefix string is added to the beginning of the symbolic name.

Windows 7:  Not supported

Child Elements

Element Description

counterSet

Identifies the counter set that contains one or more counters.

Child Element Sequence

counterSet+

Parent Elements

Element Description

counters

Groups one or more performance counter data providers and the counter sets that they provide.

Element Information

Can be empty No

Send comments about this topic to Microsoft

Build date: 10/15/2009