provider Element

Article
10/15/2009

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.

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.

counters

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

Element Information

Can be empty

Send comments about this topic to Microsoft

Build date: 10/15/2009