Building DispPerf.exe (Windows Embedded CE 6.0)

1/6/2010

DispPerf.exe is an application that gathers profiling data specifically for display drivers. The output from DispPerf.exe shows you which raster operations (ROPs) are being processed by your display driver and how much time it spends for these ROPs. For more information, see Display Driver Performance Profiling.

The following steps show how to use the Platform Builder IDE to set up and build DispPerf.exe in your run-time image.

Setting up to build DispPerf.exe

  1. Create an empty project for a Windows Embedded CE console application project named DispPerf. For more information, see Creating a New Subproject.

  2. In the Solution Explorer window, expand Subprojects, and choose DispPerf.

  3. Right-click DispPerf, choose Add, and then choose New Item.

    The Add New Item dialog box appears.

  4. Choose Code, choose C++ File (.cpp), and add a new C++ source file named DispPerf.cpp to the DispPerf project.

  5. Copy the contents of the file %_WINCEROOT%\Public\Common\OAK\Drivers\Display\DispPerf\DispPerf.cpp into the DispPerf.cpp file in your OS design's DispPerf application project.

  6. Add the following code below gpe.h in the group of #include statements at the top of DispPerf.cpp:

    #include <pwingdi.h>
    
  7. From the File menu, choose Close and then choose Yes when prompted to save the changes.

  8. Verify that DispPerf is the active project in the Subprojects node of the Solution Explorer window. It should appear in highlighted text.

  9. Right-click the DispPerf node and choose Properties.

    The Editing sources dialog box appears.

  10. Choose the C/C++ tab.

  11. In the Executable Entry Point box, type main.

    This is a case-sensitive value.

  12. In the Include Directories box, enter the full physical path for %_WINCEROOT%\PUBLIC\COMMON\OAK\INC; for example, C:\WINCE600\PUBLIC\COMMON\OAK\INC.

  13. Choose OK to close the dialog box.

    After completing these steps, you have set up the necessary files and parameters to build DispPerf.exe, but have not yet built the application.

    By default, Platform Builder builds the application when you build your run-time image. However, if you have not yet built your run-time image, you do not yet have the header files you need to build the application.

See Also

Concepts

How to Profile and Optimize a Display Driver