MediaMonitor Class Reference

#include <mythmediamonitor.h>

Inheritance diagram for MediaMonitor:

Detailed Description

Definition at line 41 of file mythmediamonitor.h.


Public Slots
void	mediaStatusChanged (MediaStatus oldStatus, MythMediaDevice *pMedia)
Public Member Functions
	~MediaMonitor ()
bool	IsActive (void) const
virtual void	StartMonitoring (void)
	Start the monitoring thread if needed.
void	StopMonitoring (void)
	Stop the monitoring thread if needed.
void	ChooseAndEjectMedia (void)
	Unmounts and ejects removable media devices.
bool	ValidateAndLock (MythMediaDevice *pMedia)
	Validates the MythMediaDevice and increments its reference count.
void	Unlock (MythMediaDevice *pMedia)
	decrements the MythMediaDevices reference count
QValueList< MythMediaDevice * >	GetMedias (MediaType mediatype)
	Ask for available media.
MythMediaDevice *	GetMedia (const QString &path)
	Get media device by pathname.
void	MonitorRegisterExtensions (uint mediaType, const QString &extensions)
	Register the extension list on all known devices.
virtual QStringList	GetCDROMBlockDevices (void)=0
Static Public Member Functions
static MediaMonitor *	GetMediaMonitor (void)
static QString	GetMountPath (const QString &devPath)
	If the device is being monitored, return its mountpoint.
static void	SetCDSpeed (const char *device, int speed)
static QString	defaultCDdevice ()
	CDDevice, user-selected drive, or /dev/cdrom.
static QString	defaultVCDdevice ()
	VCDDeviceLocation, user-selected drive, or /dev/cdrom.
static QString	defaultDVDdevice ()
	DVDDeviceLocation, user-selected drive, or /dev/dvd.
static QString	defaultCDWriter ()
	CDWriterDeviceLocation, user-selected drive, or /dev/cdrom.
static QString	defaultDVDWriter ()
	MythArchiveDVDLocation, user-selected drive, or /dev/dvd.
Protected Member Functions
	MediaMonitor (QObject *par, unsigned long interval, bool allowEject)
	Lookup some settings, and do OS-specific stuff in sub-classes.
void	CheckDevices (void)
	Poll the devices in our list.
virtual void	CheckDeviceNotifications (void)
virtual bool	AddDevice (MythMediaDevice *pDevice)=0
bool	RemoveDevice (const QString &dev)
	Remove a device from the media monitor.
bool	shouldIgnore (MythMediaDevice *device)
	Check user preferences to see if this device should be monitored.
const QString	listDevices (void)
	A string summarising the current devices, for debugging.
MythMediaDevice *	selectDrivePopup (const QString label, bool mounted=false)
	Popup a dialog box for the user to select one drive.
Static Protected Member Functions
static QString	defaultDevice (const QString setting, const QString label, char *hardCodedDefault)
Protected Attributes
QMutex	m_DevicesLock
QValueList< MythMediaDevice * >	m_Devices
QValueList< MythMediaDevice * >	m_RemovedDevices
QMap< MythMediaDevice *, int >	m_UseCount
QStringList	m_IgnoreList
bool	m_Active
	Was MonitorThread started?
bool	m_SendEvent
	Send MediaEvent to plugins?
bool	m_StartThread
	Should we actually monitor?
MonitorThread *	m_Thread
unsigned long	m_MonitorPollingInterval
bool	m_AllowEject
Static Protected Attributes
static MediaMonitor *	c_monitor = NULL
Friends
class	MonitorThread
class	MonitorThreadDarwin

Constructor & Destructor Documentation

MediaMonitor::MediaMonitor	(	QObject *	par,
		unsigned long	interval,
		bool	allowEject
	)			`[protected]`

Lookup some settings, and do OS-specific stuff in sub-classes.

Bug:: If the user changes the MonitorDrives or IgnoreDevices settings, it will have no effect until the frontend is restarted.

Definition at line 266 of file mythmediamonitor.cpp.

MediaMonitor::~MediaMonitor ( )

Definition at line 318 of file mythmediamonitor.cpp.

Member Function Documentation

bool MediaMonitor::IsActive ( void ) const [inline]

Definition at line 53 of file mythmediamonitor.h.

Referenced by Ripper::Ripper().

void MediaMonitor::StartMonitoring ( void ) [virtual]

Start the monitoring thread if needed.

Reimplemented in MediaMonitorDarwin.

Definition at line 383 of file mythmediamonitor.cpp.

Referenced by main(), and Ripper::~Ripper().

void MediaMonitor::StopMonitoring ( void )

Stop the monitoring thread if needed.

Definition at line 403 of file mythmediamonitor.cpp.

Referenced by main(), and Ripper::Ripper().

void MediaMonitor::ChooseAndEjectMedia ( void )

Unmounts and ejects removable media devices.

If no media devices are known to the MediaMonitor this function does nothing. If a single device is known, it is unmounted and ejected if possible. If multiple devices are known, a popup box is display so the user can choose which device to eject.

Definition at line 190 of file mythmediamonitor.cpp.

Referenced by myth_eject().

MediaMonitor * MediaMonitor::GetMediaMonitor ( void ) [static]

Definition at line 57 of file mythmediamonitor.cpp.

Referenced by VideoListImp::buildFsysList(), MythMainWindow::customEvent(), defaultDevice(), Ripper::ejectCD(), IconView::HandleEscape(), IconView::HandleMediaDeviceSelect(), IconView::HandleSettings(), IconView::HandleShowDevices(), main(), myth_eject(), Ripper::Ripper(), SetCDSpeed(), IconView::SetupMediaMonitor(), and Ripper::~Ripper().

QString MediaMonitor::GetMountPath ( const QString & devPath ) [static]

If the device is being monitored, return its mountpoint.

A convenience function for plugins. (Only currently needed for Mac OS X, which mounts Audio CDs)

Definition at line 489 of file mythmediamonitor.cpp.

void MediaMonitor::SetCDSpeed	(	const char *	device,
		int	speed
	)			`[static]`

Definition at line 75 of file mythmediamonitor.cpp.

Referenced by CdDecoder::setCDSpeed(), and DVDRingBufferPriv::SetDVDSpeed().

bool MediaMonitor::ValidateAndLock ( MythMediaDevice * pMedia )

Validates the MythMediaDevice and increments its reference count.

Returns true if pMedia device is valid, otherwise returns false. If this function returns false the caller should gracefully recover.

NOTE: This function can block.

See also:: Unlock(MythMediaDevice *pMedia), GetMedias(MediaType mediatype)

Definition at line 424 of file mythmediamonitor.cpp.

Referenced by VideoListImp::buildFsysList(), MythMainWindow::customEvent(), Ripper::ejectCD(), GetMountPath(), IconView::HandleMediaDeviceSelect(), IconView::HandleMediaEscape(), IconView::HandleShowDevices(), SetCDSpeed(), and IconView::SetupMediaMonitor().

void MediaMonitor::Unlock ( MythMediaDevice * pMedia )

decrements the MythMediaDevices reference count

See also:: ValidateAndLock(MythMediaDevice *pMedia), GetMedias(MediaType mediatype)

Definition at line 441 of file mythmediamonitor.cpp.

Referenced by VideoListImp::buildFsysList(), MythMainWindow::customEvent(), Ripper::ejectCD(), GetMountPath(), IconView::HandleMediaDeviceSelect(), IconView::HandleMediaEscape(), IconView::HandleShowDevices(), SetCDSpeed(), and IconView::SetupMediaMonitor().

QValueList< MythMediaDevice * > MediaMonitor::GetMedias ( MediaType mediatype )

Ask for available media.

Must be locked with ValidateAndLock().

This method returns a list of MythMediaDevice pointers which match the given mediatype.

It is potentially unsafe to use the pointers returned by this function. The devices may be removed and their associated MythMediaDevice objects destroyed. It is the responsibility of the caller to ensure that the pointers are validated and the reference count is incremented by calling MediaMonitor::ValidateAndLock() before the the returned pointer is dereferenced and MediaMonitor::Unlock() when done.