Windows NT 4.0 source code leak
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

183 lines
8.3 KiB

Release Notes for
IBM Power PC Audio Device Driver
(Version 1.04 - 04.26.96)
1. Description of IBM Power PC Audio Device Driver
The IBM Power PC Audio Device Driver (i.e., the driver) is a Windows NT
driver that consists of the following components:
- Kernel Mode device driver
- User Mode device driver
The Kernel Mode device driver component is a lowest-level driver that
supports the Crystal 423x series of Audio CODECs (i.e., it directly
reads and writes the CODEC registers and provides the Interrupt Service
Routine for the device). It provides the following features:
- supports multi-threading (concurrent use of multiple WIN32
multi-threaded applications)
- multi-processor safe
- full duplex operation (play and record simultaneously)
The Kernel Mode driver requires two DMA adapters and one IRQ. The driver
makes use of the AutoInitialize mode of the DMA services in conjunction
with a double buffering scheme and the playback and capture counters
internal to the CODEC chips. The Kernel Mode driver is modeled after the
SNDBLST Kernel Mode driver in the standard Windows NT DDK. It makes
extensive use of the SOUNDLIB library, which is also part of the standard
Windows NT DDK.
The following logical devices are supported:
- WaveIn [low-level capture functions of the multimedia API]
- WaveOut [low-level playback functions of the multimedia API]
- Mixer [mixer functions of the multimedia API]
- Aux [auxiliary functions of the multimedia API]
Detailed information related to a Kernel Mode device driver can be found
in the Kernel Mode Driver Design Guide in the MS Developers Network
documentation.
The User Mode device driver is a WIN32 Subsystem driver that provides
the API to the Kernel Mode driver for the WIN32 Subsystem. It provides
support for multi-threaded applications. Through the use of DRVLIB in
the Windows NT DDK, the User Mode device driver provides standard support
for WINMM.
Detailed information related to a User Mode device driver can be found
in the Win32 Subsystem Driver Design Guide and the MS Developers Network
documentation.
The IBM Power PC Audio Device Driver was developed at the IBM Kirkland
Programming Center (KPC) in Kirkland, WA.
2. System Requirements
The IBM Power PC Audio Device Driver supports the following IBM Personal
Power systems:
System ID Code Name OS CODEC
--------- --------- -------------- ------
IBM-6070 Carolina Windows NT 4.0 cs4232
IBM-6015 Sandalfoot Windows NT 4.0 cs4231
IBM-6042 Woodfield Windows NT 4.0 cs4231
IBM-6040 Wiltwyck Windows NT 4.0 cs4231
PowerStack PowerStack Windows NT 4.0 cs4231
IBM-7042 Tiger Windows NT 4.0 cs4232
The IBM Power PC Audio Device Driver supports the following ISA audio
cards on the IBM Personal Power systems:
- Crystal 4232 reference card
3. Installation of IBM Power PC Audio Device Driver
The IBM Power PC Audio Device Driver is comprised of the following
files:
- cs423x.sys [Kernel Mode device driver]
- cs423x.dll [User Mode device driver]
- cs423x.hlp [Windows NT Help file]
- oemsetup.inf [Installation and setup file]
- release.txt [This file]
The above files can be found at the following locations:
- Internal KPC Network [contact your network administrator at KPC]
- FTP site [contact your IBM Windows NT support personnel]
- BBS site [contact your IBM Windows NT support personnel]
If you access the BBS or the FTP site, use a floppy disk or your local
hard disk to save a copy of the IBM Power PC Audio Device Driver files.
The following describes the installation procedure on a Windows NT 4.0
system:
1. Insure that your computer is included in the list of supported
systems (see section 2 above). IF YOUR SYSTEM IS NOT INCLUDED
IN THE LIST, DO NOT ATTEMPT TO INSTALL THE DRIVER.
2. Remove all previously installed Audio drivers through the
Control Panel - Multimedia Applet. Examples are:
- cs4231 [IBM Business Audio]
- ppc4231 [IBM Power PC Audio]
- ppc4232 [IBM Power PC Audio]
- sndblst [Creative Labs SoundBlaster]
- mvaudio [Media Vision Pro Audio Spectrum/Thunderboard]
- Windows Sound System
3. Reboot your computer
4. Remove all previously installed Audio driver files. Check the
following filesystem locations:
- %SystemRoot%\System32
- %SystemRoot%\System32\drivers
5. If necessary, remove all registry references to previously
installed drivers. Check the following registry locations:
- HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
6. Install IBM Power PC Audio Device Driver through the
Control Panel - Multimedia Applet. Go to the tab labeled
'Devices'. Select the 'Add' button. Select 'Unlisted or
Updated Driver'. Specify the location according to the
sites or storage medium mentioned above.
7. Reboot your system.
4. Known Problems
a. Problem if you cancel the properties dialog box of the sound drivers
when the mixer applets is open.
b. (1. change format/2. start a DMA output transfer/3. stop the transfer/4. go to #1)
After a number of iterations of the above procedure (sometimes few,sometimes many),
the 4232 chip seems to go into an inoperative state that
requires a reboot of the system, though not necessarily a power off. The
problem does not appear with the CS4231.
5. Possible Future Development
- Power Management
- Intel HW platforms
- ISA bus Audio cards featuring the Crystal 423x series Audio CODECs
- Ameliration of IBM SoftMidi installation
- - Having made contact for more information about bug 39759.
6. Differences from previous revisions of IBM Power PC Audio Device Driver
a. Made Tiger supported
b. Made changes for PowerStack (CS423x.c) The XCTL1 bit actuates a relay in
the Comet boards that enables sound to be output to the line out jack.
c. Fixed midi problems (couldn't play two wave files, or a midi and a wave file)
in cs423xMixerInit.
d. Added cs423xWaitForDRQ (when we are ready to stop DMA of playback, we poll the DMA status register
until the DMA Request line is high. Then, we reset PEN.) for bugs 39759.
e. Changed in mix_obj.c controls from 2 -> 1 for SourceMuxAux1
f. Deleted PeakMeter for Record and, added peakmeter for all selection.
7. Revision History
Version 0x0104 User - Added Tiger in the supported machine.
Kernel - Made change for PowerStack to actuates a relay.
- Fixed midi problems.
- Seems to make the problem 39759 happens later.
- Fixed case 11, 12, 13, 20 of bug 44759.
Version 0x0103 User - (GetChipType line 156) Fix for WoodFieldPrime.
Can cancel on a Sandalfoot after changing volume settings.
Version 0x0102 Wave Format change error fix
kernel - cs423xSetFormat() in cs423x.c line 867
Saved Mixer Settings in cs423xShutdown() in dvcentry.c line 626
New Settings Dialog in cs423x.dll
Sound Icon on taskbar, multimedia applet volume control
Version 0x0101 CS4231 Master Volume and Mute, sound card support
kernel -
localmix.h, mixdvc.c, sources, release.txt,
config.c, cs423x.c, dvc423x.h
cs4231SetOutputAttenuation(), cs4231SetOutputMute()
Configuration dialog, sound card support
user -
config.c
Version 0x0100 The initial release of the IBM Power PC Audio Driver.
All files - kernel mode and user mode.