OSDLCDROMDriveHandler.h

Go to the documentation of this file.

/* 
 * Copyright (C) 2003-2009 Olivier Boudeville
 *
 * This file is part of the OSDL library.
 *
 * The OSDL library is free software: you can redistribute it and/or modify
 * it under the terms of either the GNU Lesser General Public License or
 * the GNU General Public License, as they are published by the Free Software
 * Foundation, either version 3 of these Licenses, or (at your option) 
 * any later version.
 *
 * The OSDL library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU Lesser General Public License and the GNU General Public License
 * for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License and of the GNU General Public License along with the OSDL library.
 * If not, see <http://www.gnu.org/licenses/>.
 *
 * Author: Olivier Boudeville (olivier.boudeville@esperide.com)
 *
 */


#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 ) ;
            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() ;
            
            
            
            // Virtual destructor.
            virtual ~CDROMDriveHandler() throw() ;
            
            
            
            static CDROMDriveNumber GetAvailableCDROMDrivesCount() ;
        
        
            
            CDROMDrive & getCDROMDrive( CDROMDriveNumber number = 0 ) ;
        
        
        
            virtual const std::string toString( 
                Ceylan::VerbosityLevels level = Ceylan::high ) const ;

        
        
            
        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 ) ;
            
            
            
            CDROMDriveHandler & operator = ( const CDROMDriveHandler & source );
            
            
    
    } ;



}



#endif // OSDL_CD_ROM_DRIVE_HANDLER_H_

---