|~~\\\\\\\\\\\\\\\\\\\\\\\\ |___|////////////////////// | __ __ ___ _ | | | /\ /\ / | | | |_/__v__\/__| | | | | MCI MIXER DOCUMENTATION | | | |_________________________| | | | (c) 1991 Media Vision | | v.001a | |_________________________| INTRODUCTION For some time we have been promising (threatening?) the development of an mixer driver for MCI. Accompanying this document is the initial release of mcimixer.drv, the first MCI mixer driver for the MPC level 1 platform. With this MCI driver, you can begin adding mixer control functionality to your applications without having to writing C code that calls our MMMIXER.DLL. If you are a presentation designer using a tool that allows you to send MCI strings, you now have new volume control commands at your disposal. We encourage you to begin using this new capability right away. If you have any feature requests or questions on how to use mcimixer.drv, don't hesitate to call Media Vision's Ken Nicholson at (415) 770-8600. ---------------------------------------------------------------------- DISTRIBUTION Media Vision is offering the virtual mixer interface to MPC developers license free in the hopes of a standard mixer interface being developed. We encourage developers to ship the following files with their products license free: MCIMIXER.DRV MMMIXER.DLL MVMIXER.DRV If you are shipping these files, please let us know. We may wish to assist you in promoting your product! ---------------------------------------------------------------------- INSTALLATION The mcimixer.drv file should be in your \windows\system directory. The driver entry in your system.ini file should be: mixer=mvmixer.drv ---------------------------------------------------------------------- STATUS All of the commands have been through initial testing and appear to be robust. However, some permutations of command options may not work properly. If you have any such difficulties, please contract Ken Nicholson at the above number or our Technical Support number. We will be adding commands to the MCI layer in the near future. ---------------------------------------------------------------------- reset set [channel] [to] get [channel] adjust [channel] [to] connect [to] disconnect [from] fade < [state ] | [ [channel] [to] ] > [delay] [duration] KEYWORD DESCRIPTIONS: ===================== the parameter must be either a valid mci device name or a valid alias the parameter must be one of the following key words: LINE_IN LINE_OUT DEVICE_IN DEVICE_OUT the parameter is dependent upon the . For "line_in" and "line_out", must be a number between 1 and the number of lines (input or ouput) supported by the mixer. For "device_in" and "device_out", must be a one of the standard 3-letter names for device types: name: Description: -------------------------------------------------- N/C No Connection AAT Analog Audio Tape AMP Amplifier AUX Auxillary CDA Compact Disk Player DAT Digital Audio Tape EQU Equalizer LPA Phonograph MIC Microphone MIX Mixer MUS Musical Instrument RAD Radio SPK PC speaker TEL Telephone TVA Television Audio VTR Video Tape Recorder VDP Video Disc Player WAV Digital Waveform Player UNK Unknown Device Type the parameter is an optional parameter with the default being volume. If used, this parameter must be one of the following key words: VOLUME volume control ALC auto level control BASS Bass MIDRANGE Midrange TREBLE Treble CROSSOVER Stereo to left, right or exchange channels LOUDNESS Bass boost for low volumes MUTE disables audio, maintains current volume REVERB reverb control STEREOENHANCE increase stereo separation CUSTOM1 CUSTOM2 CUSTOM3 the parameter is an optional parameter with the default being "BOTH". If used, this parameter must be one of the following key words: LEFT RIGHT BOTH the parameter must be an integer between 0 and 100 (inclusive). This value represents the percentage of the maximum allowable value. the parameter must be a legal integer. It represents the number of tenths of seconds that are to elapse before the specified fade operation is to begin. the parameter must be a legal integer. It represents the time, in tenths of seconds, for the specified fade operation to occur. the parameter must be a fully qualified pathname to a mixer state file (.MIX extension). Promix.exe is used to create these files. !@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@!@ The following are some sample MCI commands that can be used to control the mixer hardware. The program MCITEST.EXE, which is included as a sample application with the Microsoft Multimedia Development Kit (MDK), provides an easy way to try out some of these commands. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - You should precede each of the commands by the following line: open mixer alias mix When you are finished sending commands, send this line: close mix - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To reset the mixer to the startup settings as specified in WIN.INI: reset mix - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To instantly change the volume of a specific mixer input line to 75%: set mix line_in 3 control volume to 75 which is the same as: set mix line_in 3 control volume 75 set mix line_in 3 to 75 set mix line_in 3 75 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To instantly change the volume of a CD-ROM device on an unknown mixer input line to 75%: set mix device_in CDA control volume to 75 which is the same as: set mix device_in CDA control volume 75 set mix device_in CDA to 75 set mix device_in CDA 75 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To find out the current volume of a CD-ROM device on an unknown mixer input line to 75%: get mix device_in CDA control volume which is the same as: set mix device_in CDA set mix device_in CDA 75 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To find out the current bass EQ setting of the AMPLIFIER output line: get mix device_out AMP control bass - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To instantly reduce the setting of the AUX input volume to 10% less than the current setting: adjust mix device_in AUX control volume -10 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To instantly connect both the microphone and the CD audio inputs to the output which goes to the record circuitry: connect mix device_in MIC to device_out WAV connect mix device_in CDA to device_out WAV - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To instantly disconnect the microphone input from the record circuitry: disconnect mix device_in MIC from device_out WAV - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To instantly change the state of the mixer to a state that was previously saved to disk: fade mix state c:\windows\saved.mix - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To gradually fade out the volume of the Adlib-compatible FM synthesizer input over 30 seconds: fade mix device_in MUS to 0 duration 300 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - To wait 10 seconds then gradually fade the master volume to 50% over the course of 5 seconds: fade mix device_out AMP to 50 delay 100 duration 50 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Note: It is not necessary to fade a volume gradualy over .1 seconds to avoid noise. All mixer volume changes are implemented by changing the volumes a step at a time to reach the desired setting.