OSDLCDROMDriveHandler.h

Go to the documentation of this file.

#ifndef OSDL_CD_ROM_DRIVE_HANDLER_H_
#define OSDL_CD_ROM_DRIVE_HANDLER_H_


#include "OSDLException.h"   // for OSDL::Exception

#include "Ceylan.h"          // for inheritance


#include <string>
#include <map>


namespace OSDL
{

    
    
    class OSDL_DLL CDROMDriveException : public OSDL::Exception
    {
    
        public:
            
            CDROMDriveException( const std::string & message ) throw() ;
            virtual ~CDROMDriveException() throw() ;
    
    } ;
    
    
    
    typedef Ceylan::Count CDROMDriveNumber ;
    
    
    // CD-ROM handler manages CD-ROM drives.
    class CDROMDrive ;
    
    
    class OSDL_DLL CDROMDriveHandler : public Ceylan::Object
    {
    
        
        public:
        
        
            CDROMDriveHandler() throw( CDROMDriveException ) ;
            
            
            // Virtual destructor.
            virtual ~CDROMDriveHandler() throw() ;
            
            
            static CDROMDriveNumber GetAvailableCDROMDrivesCount() throw() ;
        
            
            CDROMDrive & getCDROMDrive( CDROMDriveNumber number = 0 ) 
                throw( CDROMDriveException ) ;
        
        
            virtual const std::string toString( 
                Ceylan::VerbosityLevels level = Ceylan::high ) const throw() ;

        
            
        private:
    
            
/* 
 * Takes care of the awful issue of Windows DLL with templates.
 *
 * @see Ceylan's developer guide and README-build-for-windows.txt 
 * to understand it, and to be aware of the associated risks. 
 * 
 */
#pragma warning( push )
#pragma warning( disable : 4251 )
            
            std::map<CDROMDriveNumber, CDROMDrive *> _drives ;
            
#pragma warning( pop ) 
            

            explicit CDROMDriveHandler( const CDROMDriveHandler & source )
                throw() ;
            
            
            CDROMDriveHandler & operator = ( const CDROMDriveHandler & source )
                throw() ;
            
    
    } ;


}



#endif // OSDL_CD_ROM_DRIVE_HANDLER_H_

---