[This is
preliminary documentation and subject to change.]
This sample demonstrates
the basics of writing a control panel applet. The sample only works in
conjunction with the AC97 property page sample which in turn requires the AC97
WDM audio driver sample. The AC97 WDM audio driver sample runs on an Intel®
motherboard with integrated AC97 controller, like the Intel 810 Chipset.
Microsoft discourages the use of control panel applets since cluttering
of the control panel is confusing to most users. Most of the functionality that you might want to
provide can be added in a property sheet that is added to the property page of
your device. See the proppage sample for how to write a property page DLL.
Microsoft also discourages
the use of system tray programs (programs that get displayed in the
notification area of the system tray). These programs are running all the time
and eat up resources. The notification area of the system tray is for notifying
the user of events only.
In case you find you
can’t get all the functionality or configuration options you need into the
property page of your device driver, this sample shows you how to write a
control panel applet that might provide more extensive configuration options
and/or functionality.
To build this sample,
enter any Windows .NET or Windows XP build environment and run build –cZ from the AC97 directory (parent
directory). This would also compile the AC97 WDM audio
driver sample and the property page sample that is needed for this sample to
work.
The INF named
‘AC97smpl.inf’ included in the AC97 subdirectory (parent directory) can be used
to install the AC97 property page sample and the AC97 WDM audio driver sample
that is needed for this sample. Simply copy the INF and the AC97 driver binary
and the property page sample binary to a floppy disk and then update the driver
for the device with the one from the floppy. After updating the driver, the
control panel applet can be installed by simply copying the binary to the
%SystemRoot%\System32 directory.
ADDITIONAL
INFORMATION TO THE SAMPLE
This
control panel applet simply creates a dialog and loads the AC97 property page
sample that in turn provides a property sheet to this dialog. The control panel
applet then displays the dialog. The interesting part in this sample is to find
the AC97 WDM audio driver sample in the system since this information needs to
be passed to the AC97 property page sample.
File Description Ac97cpl.cpp Includes all the code necessary for the sampleAc97cpl.def To build the CPLAc97cpl.ico The iconAc97cpl.rc Property sheet definitionMakefile Standard Windows NT makefileReadme.htm This fileSources Dependency information for compilingVersion.h Version information