README for PDH Support Kit for Delphi 2.0 and 3.0
-------------------------------------------------

This source code is freeware. For licensing details, please refer
to the Licensing section.

=======================================================================

Revision 1.0 of August 27, 1997. Copyright 1997 Alexander Staubo
<alex@powertech.no>.

For future updates, watch my home page at

  http://home.powertech.no/alex/

=======================================================================


Contents
--------

About This Source Code
Installation
Licensing
Feedback and Support
Disclaimer


=======================================================================


About This Source Code
----------------------

This is a translation of the Performance Data Helper (PDH) API
for Windows NT, to ObjectPascal and Borland Delphi.

The PDH API is an interface to the performance monitoring support
in Windows NT. Using these files you can write applications which
monitor performance counters, similar to Performance Monitor, or
you can write a performance DLL that collects data for such
programs. For example, you can write a DLL which keeps count of
the number of transactions being processed by another app -- in
this case you would add an object, something like "My Transaction
Object" with the counters "Current Transactions" and "Total
Transactions". The performance API supports both local and remote
performance collection, so a performance DLL can collect data for
an instance of Performance Monitor running remotely.

You will need the pdh.dll DLL that comes with the Microsoft Win32
SDK for Windows NT and Windows95 in order to write applications
that use this API. You do not need this DLL to write performance
DLLs. The units have been briefly tested with Delphi 3.0 under NT
4.0 and SP3; it should be compatible with Delphi 2.0x. Only
32-bit compilation is supported.

In the source code, a comment such as {!! something } is a
translator's comment. All other comments are as translated from
the original source code.

The directory plan_b contains a slightly different set of header
file units. In these units, the case and naming convention of all
the identifiers have been preserved. In the main units,
identifiers have been renamed (eg., PERF_COUNTER_DEFINITION to
TPerfCounterDefinition) to use the "Delphian" naming convention.
If you are porting existing C/C++ code to use the PDH units, you
might want to use the "plan B" units instead as they will let you
use the original C names.

This translation has not been sactioned by Microsoft. I am
currently inquiring about the legality of this translation and
other, similar translations.


Installation
------------

1. Copy the source files into a directory, eg. c:\pdh.

2. Ensure that pdh.dll is installed on your system. It should
exist in the bin directory underneath your Win32 SDK installation
(eg., c:\mstools\bin).

3. For any applications that must use the units, add the line

  uses Pdh, Winperf;

to the program or unit.


Licensing
---------

This software is released as "freeware". You are encouraged to
redistribute unmodified copies this software, as long as no fee
is charged for the software, directly or indirectly, separately
or as part of ("bundled with") another software product, without
the express permission of the author (Alexander Staubo). Users
are encouraged to improve the source code, and you may modify
this software as long as you do not redistribute the modified
version.


Feedback and Support
--------------------

You are encouraged to send bug reports and suggestions.
Contributors will be rewarded by having their names mentioned in
the "readme" file of every subsequent release. Fame and glory is
optional. If you modify the source code, you are also encouraged
to email me your modified version if you think your additions
would be worthwhile to other users.

This software is not supported. Hence, your technical questions
may or may not be answered. If they're sufficiently intelligent
and well-written, however, there is a good chance they will.

Questions, bug reports, comments and suggestions should all be
sent to <alex@powertech.no>, subject line "PDH headers".


Legal Disclaimer
----------------

ANY USE BY YOU OF THE SOFTWARE IS AT YOUR OWN RISK. THE SOFTWARE
IS PROVIDED FOR USE "AS IS" WITHOUT WARRANTY OF ANY KIND. TO THE
MAXIMUM EXTENT PERMITTED BY LAW, THE AUTHOR (ALEXANDER STAUBO)
DISCLAIMS ALL WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, WITHOUT LIMITATION, IMPLIED WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. THE AUTHOR (ALEXANDER STAUBO) IS NOT OBLIGATED
TO PROVIDE ANY UPDATES TO THE SOFTWARE.


=======================================================================


