The waveaudio device directly supports one wave stream connector which is always enabled. As it is likely that an application will need to select the recording source or the output destination on the amplifier-mixer device, the waveaudio device will attempt to provide the following connector services to an application. If the requested connector is not available, the command will fail.
Additional connectors might be available on the ampmix device. To control these connectors obtain the device ID of the ampmix device using the MCI_CONNECTION message and issue the connector command directly to the associated amplifier-mixer.
To determine which connectors are supported by an amplifier-mixer device, use the MCI_CONNECTORINFO message.
The Audio Recorder Sample program illustrates the concept of recording audio data. In order to do this, it first configures the device settings such as the input source as shown in the following code fragment.
MCI_CONNECTOR_PARMS mciConnectorParms; /* for MCI_CONNECTOR *//*
* Set up input source - microphone or line in.
* Initialize MCI_CONNECTOR_PARMS structure with the pertinent
* information, and then issue an MCI_CONNECTOR command by way of
* mciSendCommand.
*/
mciConnectorParms.ulConnectorType = usDeviceType;
/* microphone/linein */
ulError = mciSendCommand( mciOpenParms.usDeviceID,
MCI_CONNECTOR,
MCI_WAIT | MCI_CONNECTOR_TYPE |
MCI_ENABLE_CONNECTOR,
(PVOID) &mciConnectorParms,
0 );
if (ulError)
{
ShowMCIErrorMessage( ulError);
return( FALSE);
}