This document contains the description of the Windows 98 AVI Sound Track problem fix for ToolBook 6.0.

  Instructor 6.5: Already has this fix built-in.
  Assistant 6.5a: Already has this fix built-in.
   Assistant 6.5: Does not have this fix build-in, as it was  
                  released before the fix was developed.


SUMMARY OF CHANGES:

 1.  Auto Detection of sound drivers which support 'virtual 
     sound devices'.

 2.  Toolbook ini entry for hardware that supports virtual 
     sound devices. (regardless of autodetection)

 3.  Toolbook ini entry for hardware that does not support 
     virtual sound devices. (regardless of everything else).


HOW THE DETECTION WILL NOW WORK:

 1.  AutoDetection - by inspecting the sound channel.
     This can be disabled by adding this to the TB60.INI:

      [ToolBook]
      VirtualSoundAutoDetect=0

 2.  Next we look to see if it is a sound driver that we know 
     supports virtual sound devices.

 3.  Next we check to see if the driver we are using is in this 
     following list. If it is, virtual sound device support is enabled.
     This list is contained in the TB60.INI.

      [ToolBook]
      VirtualSoundDevices=<comma seperated list. no spaces between commas>

      (Note: entries in the list override autodetection)

 4.  Next we check to see if the driver we are using is in this 
     following list. If it is, virtual sound device support is disabled.

      [ToolBook]
      VirtualSoundExcludes=<comma seperated list. no spaces between commas>

      (Note: regardless of everything else, if it's excluded...it's excluded.)

 5.  At this point we should know what type of hardware management 
     Lionel should use regarding the sound channel(s).

     The actual work that Lionel does for playing multimedia is the same, 
     the problem here was that Lionel expected the hardware to behave a 
     certain way unless it was an Mwave card. Lionel now figures out 
     what it needs to do based on how the driver handles things.

 6.  For the vast majority of sound cards, autodetection will work. The ini 
     entries are provide as a way of forcing Lionel to behave a specific way 
     in the event that autodetection doesn't happen properly.

 7.  How to determine what your driver name is, in the event you need to add
     it to the TB60.INI in step 3 or 4:

      [ToolBook]
      VirtualSoundLog="c:\soundlog.txt"

     If this entry is found in the TB60.INI, ToolBook will write various 
     information about what Lionel detects during the VirtualSound Autodetection 
     sequence.

     The most interesting thing here is probably that the driver name which a 
     particular device uses is written out to the log file.


HOW TO INSTALL THE FIX:

 1.  Before installing the updated tb60lnl.dll file, back up your current 
     tb60lnl.dll file by copying this file to a different directory. The 
     default location for the ToolBook system files is:

     c:\program files\asymetrix\shared tools\tbsystem.

 2.  After backing up your current tb60lnl.dll file, copy the updated 
     tb60lnl.dll file to your ToolBook system file directory, overwriting 
     the older version of this file. The default location for the ToolBook 
     system files is:

     c:\program files\asymetrix\shared tools\tbsystem.