MpidOss Class Reference

Container for device specific input OSS driver. More...

#include <MpidOss.h>

Inheritance diagram for MpidOss:

Collaboration diagram for MpidOss:

Public Member Functions
Creators
	MpidOss (const UtlString &name, MpInputDeviceManager &deviceManager)
	Default constructor. More...
	~MpidOss ()
	Destructor. More...
Manipulators
OsStatus	enableDevice (unsigned samplesPerFrame, unsigned samplesPerSec, MpFrameTime currentFrameTime)
	Initialize device driver and state. More...
OsStatus	disableDevice ()
	Uninitialize device driver. More...
Inquiry
UtlBoolean	isDeviceValid ()
	Inquire if the OSS device is valid. More...
Public Member Functions inherited from MpInputDeviceDriver
	MpInputDeviceDriver (const UtlString &name, MpInputDeviceManager &deviceManager)
	Default constructor. More...
virtual	~MpInputDeviceDriver ()
	Destructor. More...
virtual OsStatus	setDeviceId (MpInputDeviceHandle deviceId)
	Set device ID associated with this device in parent input device manager. More...
virtual OsStatus	clearDeviceId ()
	Clear the device ID associated with this device. More...
virtual MpInputDeviceHandle	getDeviceId () const
	Get device ID associated with this device in parent input device manager. More...
uint32_t	getSamplesPerSec () const
	Get the sample rate of this device driver, if enabled. More...
uint32_t	getSamplesPerFrame () const
	Get the samples per frame of this device driver, if enabled. More...
MpFrameTime	getFramePeriod ()
	Calculate the number of milliseconds that a frame occupies in time. More...
MpFrameTime	getCurrentFrameTime () const
	Get timestamp for the next frame to be pushed to input device manager. More...
const UtlString &	getDeviceName () const
	Get device name. More...
virtual UtlBoolean	isEnabled ()
	Inquire if this driver is enabled. More...

Protected Member Functions
OsStatus	initBuffers ()
	Allocate internal OSS buffers. More...
void	freeBuffers ()
	Free internal OSS buffers. More...
MpAudioSample *	getBuffer ()
	Get buffer from internal buffers. More...
void	pushFrame ()
	Push audio frame to InputDeviceManager. More...
void	skipFrame ()
	Add frame time to mCurrentFrameTime. More...

Protected Attributes
MpAudioSample *	mAudioFrame
	Wave buffer. More...
MpOssContainer *	mpCont
	Pointer to Wrapper container. More...
Protected Attributes inherited from MpInputDeviceDriver
MpInputDeviceManager *	mpInputDeviceManager
	this device driver. More...
UtlBoolean	mIsEnabled
	Whether this device driver is enabled or not. More...
MpInputDeviceHandle	mDeviceId
	this device, as supplied by the InputDeviceManager. More...
unsigned	mSamplesPerFrame
	number of samples. More...
unsigned	mSamplesPerSec
	of samples per second. More...
MpFrameTime	mCurrentFrameTime
	pushed to input device manager. More...

Private Member Functions
	MpidOss (const MpidOss &rMpInputDeviceDriver)
	Copy constructor (not implemented for this class). More...
MpidOss &	operator= (const MpidOss &rhs)
	Assignment operator (not implemented for this class). More...

Private Attributes
MpOss *	pDevWrapper

Friends
class	MpOss

Additional Inherited Members
Static Public Member Functions inherited from MpInputDeviceDriver
static MpFrameTime	getFramePeriod (unsigned samplesPerFrame, unsigned samplesPerSec)
	Calculate the number of milliseconds that a frame occupies in time. More...

Detailed Description

Container for device specific input OSS driver.

Constructor & Destructor Documentation

MpidOss	(	const UtlString &	name,
		MpInputDeviceManager &	deviceManager
	)

Default constructor.

Parameters

name	- (in) unique device driver name (e.g. "/dev/dsp", "YAMAHA AC-XG WDM Audio", etc.).
deviceManager	- (in) MpInputDeviceManager this device is to push frames to via pushFrame method.

~MpidOss

(

)

Destructor.

MpidOss ( const MpidOss &  rMpInputDeviceDriver )

private

Copy constructor (not implemented for this class).

Member Function Documentation

OsStatus enableDevice ( unsigned  samplesPerFrame, unsigned  samplesPerSec, MpFrameTime  currentFrameTime  )

virtual

Initialize device driver and state.

This method enables the device driver.

this SHOULD NOT be used to mute/unmute a device. Disabling and enabling a device results in state and buffer queues being cleared.

Parameters

samplesPerFrame	- (in) the number of samples in a frame of media
samplesPerSec	- (in) sample rate for media frame in samples per second
currentFrameTime	- (in) time in milliseconds for beginning of frame relative to the MpInputDeviceManager reference time

Implements MpInputDeviceDriver.

OsStatus disableDevice ( )

virtual

Uninitialize device driver.

This method disables the device driver and should release any platform device resources so that the device might be used else where.

this SHOULD NOT be used to mute/unmute a device. Disabling and enabling a device results in state and buffer queues being cleared.

Implements MpInputDeviceDriver.

UtlBoolean isDeviceValid ( )

inlinevirtual

Inquire if the OSS device is valid.

Implements MpInputDeviceDriver.

OsStatus initBuffers ( )

protected

Allocate internal OSS buffers.

void freeBuffers ( )

protected

Free internal OSS buffers.

MpAudioSample* getBuffer ( )

protected

Get buffer from internal buffers.

void pushFrame ( )

protected

Push audio frame to InputDeviceManager.

void skipFrame ( )

protected

Add frame time to mCurrentFrameTime.

MpidOss& operator= ( const MpidOss &  rhs )

private

Assignment operator (not implemented for this class).

Friends And Related Function Documentation

friend class MpOss

friend

Member Data Documentation

MpAudioSample* mAudioFrame

protected

Wave buffer.

MpOssContainer* mpCont

protected

Pointer to Wrapper container.

MpOss* pDevWrapper

private