|Important||This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer|
Adding an ATL Performance Monitor Object Manager
Use the ATL Performance Monitor Object Manager Wizard to add a performance monitor object manager (perfmon), in either attributed (perfmon) or nonattributed (CPerfMon) form to an ATL DLL project.
Note You can use the ATL Project Wizard to create an ATL project, or you can add an ATL object to your MFC application to implement ATL support for an MFC application.
Creating a performance monitor object manager is the first step to adding performance monitoring support to your system or server project. Performance monitoring allows your applications and components to publish, capture, and analyze the performance data that applications, services, and drivers provide. You can use this information to determine system bottlenecks and fine-tune system and application performance.
You must create a performance monitor object manager in an ATL DLL project before you can add performance objects and implement performance counters for the object. A performance monitor object manager can have multiple performance objects, which in turn can have multiple counters. The following figure illustrates how the performance monitoring architecture works in your ATL project.
Performance Monitor Object Manager with Performance Objects and Counters
To add an ATL performance monitor object manager to your project
- In either Solution Explorer or Class View, right-click the name of the project to which you want to add the ATL performance monitor object manager.
- From the shortcut menu, click Add, and then click Add Class.
- In the Add Class dialog box, in the Templates pane, click ATL Performance Monitor Object Manager, and then click Open to display the ATL Performance Monitor Object Manager Wizard.
By clicking Generate Sample Object in the ATL Performance Monitor Object Manager Wizard, you automatically add one sample performance object to the performance monitor object manager and one sample performance counter to the performance object.
Note A performance monitor can work with an ATL service, but such a service must be added to the ATL DLL project containing the performance monitor. See Performance Monitoring for more information.
Performance Objects and Counters