80 lines
3.5 KiB
Plaintext
80 lines
3.5 KiB
Plaintext
UCS-Managed - Usermode Counter Sample for managed code providers.
|
|
=================================================
|
|
Demonstrates providing performance counter data from a .Net application using System.Diagnostics.PerformanceData namespace.
|
|
The functionality of this sample is identical to that of the native code UCS sample.
|
|
|
|
Languages
|
|
===============================
|
|
This sample is available in the following language implementations:
|
|
C#
|
|
|
|
Files
|
|
=================================================
|
|
Readme.txt: This file
|
|
|
|
ucs.cs: Usermode Counter Sample. Main implementation file.
|
|
This could be a target application to be monitored.
|
|
|
|
ucs.man: Counter manifest file. This file describes counter information (e.g., counter name,
|
|
type, description). You can use ecmangen.exe tool to help generate a counter manifest file.
|
|
|
|
ucs.rc: Generated resource file that contains all localized strings. As ucs.man only contains
|
|
English strings, so does this file (and localization team can localize strings there).
|
|
This file is generated from ucs.man by running ctrpp.exe tool. Example command-line:
|
|
ctrpp -rc ucs.rc ucs.man
|
|
|
|
ucs.res: Compiled resource file generated from ucs.rc by running rc.exe tool. Example command-line:
|
|
rc.exe /r /i "c:\Program Files\Microsoft SDKs\Windows\v7.0\Include" ucs.rc
|
|
|
|
|
|
Prerequisites
|
|
=================================================
|
|
This sample requires .NET 3.5 or later and Windows Vista or later.
|
|
|
|
|
|
To build the sample using Visual Studio 2008:
|
|
================================================
|
|
1. Open Windows Explorer and navigate to the directory.
|
|
|
|
2. Double-click the icon for the .sln (solution) file to open the file in Visual Studio.
|
|
|
|
3. In the Build menu, select Build Solution. The application will be built in the default \Debug or \Release directory.
|
|
|
|
NOTE that the compiled resource file, ucs.res, has been already added to your project's Application property page.
|
|
That causes Win32 resources describing the counter data to be linked with your managed assembly.
|
|
|
|
ALSO NOTE the post-build step: lodctr.exe /m:"$(TargetDir)ucs.man"
|
|
Lodctr.exe tool registers counters on your computer. You need to run this tool as part of your application deployment.
|
|
|
|
|
|
To run the sample
|
|
=================================================
|
|
1. Make sure that the post-build lodctr.exe tool has executed successfully and that ucs.man is located in the same directory as ucs-managed.exe.
|
|
|
|
2. Navigate to the directory that contains the ucs-managed.exe, using the command prompt or Windows Explorer.
|
|
|
|
3. Type ucs-managed.exe at the command line, or double-click the icon for ucs-managed.exe to launch it from Windows Explorer.
|
|
|
|
|
|
To Test the sample
|
|
=================================================
|
|
1. Open Perfmon.
|
|
|
|
Start -> Run -> Type "Perfmon" -> ENTER
|
|
|
|
2. Open the "Add counters" dialog.
|
|
|
|
You can see two new objects, "Geometric Waves Managed" and "Trigonometric Waves Managed", under the object
|
|
|
|
3. Add a counter.
|
|
|
|
Choose, for instance, "Geometric Waves Managed" and its counter, "Square Wave" and select <All instances>
|
|
in the "Instances of selected object" window, and then press ADD.
|
|
|
|
|
|
To uninstall the sample
|
|
=================================================
|
|
If you would like to uninstall the counter, run the following command:
|
|
|
|
unlodctr /m:ucs.man
|