const CString szIniFile holds the path of a temporary file that contains certain items that may be useful to an event handler. This file is arranged as a standard Windows INI file and should be accessed using the GetPrivateProfileString and GetPrivateProfileInt functions. An event handler should pick information from this file as needed but should never "remember" the file name.
The contents of the file are illustrated by this example:
[Directories]
DecoderDirs=C:\Program Files\MyProductInstallation\App Data\Decoders\;C:\ Program Files\MyProductInstallation\My Decoders\;
[Config]
StreamName0=DTE
CharsPerSec0=10416.6666666667
TicksPerChar0=22916
StreamName1=DCE
CharsPerSec1=10416.6666666667
TicksPerChar1=22916
DecoderDirs in the Directories section contains a list of directories that may contain decoder (.DEC) files.
In the Config section, StreamNameN gives the name for the stream when iStream equals N. CharsPerSecN gives the maximum throughput for stream N in characters per second. And TicksPerCharN gives the number of 900- nanosecond ticks per character time for stream N. Note that the name "CharsPerSec" is used for good reason: this counts characters no matter what size they are (e.g. 7-bit or 8-bit) not necessarily bytes.