[This is
preliminary documentation and subject to change.]
This sample demonstrates
the basics of writing a GFX property page and can be used as a base to write
your own GFX property dialog. The sample only works together with the audio GFX
filter sample which is tied to the Microsoft DSS 80 USB speakers. You can apply
the sample to different USB speakers, however, you need to modify the INF file
and replace the PnP ID of the Microsoft DSS 80 USB speakers with the PnP ID of
your USB speakers.
After you install the
audio GFX filter together with this sample, the property dialog will appear
when you open the ‘Advanced Audio Properties’ and click on the ‘properties’
button for the USB speakers in the ‘Effects’ tab. In this dialog you basically can
enable or disable the GFXSwap functionality.
To build this sample,
enter the free or checked Windows XP build environment and run build
from the parent directory, rather than this subdirectory. This would also
compile the audio GFX filter sample that is needed for this sample to work.
The INF named ‘gfxswap.inf’, which is included in the parent directory,
can be used to install the sample after it has been built. Simply copy the INF
and this sample binary and the GFX filter binary to a floppy disk and right
click the INF file and choose ‘Install’ on your test machine. Please also refer
to the ‘readme.htm’ file in the parent directory.
Once the sample set has
been installed with the INF, the binary may be updated by copying the new binary
into %SystemRoot%\System32 on the target machine, provided that there are no
INF changes.
ADDITIONAL
INFORMATION TO THE SAMPLE
The
GFX Property sample communicates with the GFX filter through a property. This
property is sent to the only node that the GFX filter has. Since the node is
new (specific to the GFX filter sample), the property is new (private) too.
The
project was generated using the ATL wizard of Microsoft Visual C++ 6.0. The
project workspace file still exists, so you can open the project with Microsoft
Visual C++ 6.0 (or later). If you want to create your own project it is
probably a good idea to use the wizard and create a new project instead of
renaming this project and modifying it. If you choose the latter, please make
sure you read the documents in the parent directory about GUID dependencies.