/*

 @capability MultimediaDD

 This function creates the handle to the sound media driver.

 @param aUnit	A unit of the device.

 @return KErrNone on success, otherwise system wide error code.

 @capability MultimediaDD

*/

/*

 Gets the version object of sound media driver.

@return version object.

*/

/*

 Indicates whether the driver is sound media driver.

@return KErrNone on success, otherwise System wide error code.

*/

/*

 This function gets the play volume. 

 The range of volume level supported depends on the physical audio device used.

@return Volume level.

*/

/*

 This function sets the play volume.

 The volume level depends on the physical audio device used.

@param aVolume	Play volume level in the range 0 to 255 inclusive

@see TSoundFormatsSupported

*/

/*

 This function sets the play volume.

 The volume level depends on the physical audio device used.

@param aVolume	Play volume level. Logarithmic value.

@see TSoundFormatsSupported

*/

/*

 This function cancels the currently playing sound.

 If paused, the pause will be cancelled.

 Will panic if not open.

 Will not cancel Notify*Error().

*/

/*

 Gets the sound record volume.

 This depends on the physical audio device used.

@return Record volume level.

*/

/*

 This function sets the device record volume level.

 This depends on the physical audio device used.

@param aLevel Record volume level.	

@see TSoundFormatsSupported

*/

/*

 This function cancels the recording in progress.

 If paused, the pause will be cancelled.

 Any buffered data will be discarded.

 Will panic if not open.

 Will not cancel Notify*Error().

*/

/*

 This function stops recording and completes the outstanding RecordData request immediately with any available data.

 Any following RecordData calls will be completed immediately returning any buffered data, they will NOT restart recording.

 It  maybe called either when recording or stopped.

 The flushing state should be exited by calling CancelRecordData.

 The adaptor implements this functionality via Pause, which results in slightly different behaviour to the old RMdaDevSound driver.

 In particular the flushing state can also be exited by calling ResumeRecording, do NOT do  this... If you want this behaviour, use the

 new PauseRecording/ResumeRecording functions.

 */

/*

 This function returns the number of bytes played by the driver since calling Open or 

 calling ResetBytesPlayed().

 It is not reset by PlayData or PausePlayBuffer/ResumePlayBuffer

@see RMdaDevSound::ResetBytesPlayed() 

@return Number of bytes played.

*/

/*

 Resets the count of bytes played.

 If called whilst playing, the counter might not reset to exactly zero, it will reset to the number of bytes played in the current

 internal transfer.

*/

/*

 This function changes the audio play state to pause.

 It is legal to pause whilst not playing, in which case a following (single) PlayData request will be queued until

 ResumePlaying is called.

*/

/*

 This function starts the audio play from pause state.

 If a PlaData request was active when the Pause was requested it will continue.

 If a PlayData request was not active when the Pause was requested, but a one was issued whilst paused,

 it will start.

 If there is nothing to resume, we will notify KErrUnderflow.

*/

/*

 This function is identical to RMdaDevSound::ResumePlaying(), the parameter is ignored.

*/

/*

The current record request will be completed early with partial contents and further

recording paused.

Any following RecordData calls will be completed immediately using any buffered data, it will NOT restart recording.

*/

/*

	Resume recording.

	Recorded data will be buffered internally.

	If an outstanding RecordData request was issued whilst paused it will be processed.

*/

/*

	Return the duration of the audio data which has been played.

	Note that this may be less than the amount of data/time queued.

*/

/*

 Gets the play format(capability) supported by this device. 

 This record describes supported sample rate, encoding, volume level, channels, buffer size of the audio for playing. 

@param  aFormatsSupported	A reference to a client supplied TSoundFormatsSupported class to be filled by this function. 

@see TSoundFormatsSupported

*/

/*

 This function gets the current play format.

@param  aFormat	A reference to a client supplied TCurrentSoundFormat class to be filled by this function. 

@see TCurrentSoundFormat

*/

/*

 This functions sets the play format.

@param aFormat For the details refer to TCurrentSoundFormat. 

@see TCurrentSoundFormat

@return KErrNone on success,

		KErrInUse if playing, 

        KErrAccessDenied if play and recording sample rate is different,

        KErrNotSupported if input sound format does not match with supported capability,

        otherwise system wide error code.

*/	

/*

 Gets the sound record format. 

 This record describes supported sample rate, encoding, volume level, buffer size of the audio for recording.

 This depends on the physical device used.

@param  aFormatsSupported	A reference to a client supplied TSoundFormatsSupported class to be filled by this function.  

@see TSoundFormatsSupported

*/

/*

 Gets a current sound format used for recording.

@param aFormat	A reference to a client supplied TCurrentSoundFormat class to be filled by this function.

@see TCurrentSoundFormat

*/

/*

 Call this function to change the sound format used for recording.

@param aFormat	For details refer to TCurrentSoundFormat. 

@see TCurrentSoundFormat

@return KErrNone on sucess,

        KErrInUse  if recording already in progress,

        KErrAccessDenied   play and record sample rates are different,

        otherwise system wide error code.

*/

/*

 Call this function to play the audio data in the supplied descriptor.

Only a single request may be outstanding at any point in time.

If paused, the request will be queued until ResumePlaying is called.

@param  aStatus	For details refer to TRequestStatus. 

@see TRequestStatus

@param	aData	Descriptor with play data

*/

/*

 Records audio data into the supplied descriptor.

Only a single request may be outstanding at any point in time.

If paused, the request will be queued until ResumeRecording is called.

@param  aStatus	Request status

@see TRequestStatus

@param  aData	Record buffer descriptor.

*/

/*

 Call this function to notify any error encountered while recording audio.

@param  aStatus	request object's completion code value 

@see TRequestStatus

*/

/*

 Call this function to notify the play error encountered while playing the sound.

@param aStatus	Error code stating the cause for the play error.

*/

/*

 This function cancels the play notification error.

*/

/*

 This function cancels the recording error notification.

*/

/*

This function cancels the currently playing sound.

If paused, the pause will be cancelled.

 This function is identical to CancelPlayData

*/