1: <?php
  2: /**
  3:  * LICENSE (BSD)
  4:  *
  5:  * Copyright (c) 2012, Gerd Christian Kunze
  6:  * All rights reserved.
  7:  *
  8:  * Redistribution and use in source and binary forms, with or without
  9:  * modification, are permitted provided that the following conditions are
 10:  * met:
 11:  *
 12:  *  * Redistributions of source code must retain the above copyright
 13:  *    notice, this list of conditions and the following disclaimer.
 14:  *
 15:  *  * Redistributions in binary form must reproduce the above copyright
 16:  *    notice, this list of conditions and the following disclaimer in the
 17:  *    documentation and/or other materials provided with the distribution.
 18:  *
 19:  *  * Neither the name of Gerd Christian Kunze nor the names of the
 20:  *    contributors may be used to endorse or promote products derived from
 21:  *    this software without specific prior written permission.
 22:  *
 23:  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
 24:  * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 25:  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 26:  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 27:  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 28:  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 29:  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 30:  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 31:  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 32:  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 33:  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 34:  *
 35:  * Extension
 36:  * 30.08.2012 22:14
 37:  */
 38: namespace MOC\Generic\Device;
 39: use MOC\Generic\Common;
 40: 
 41: /**
 42:  *
 43:  */
 44: interface Extension extends Common {
 45: 
 46:     /**
 47:      * Create new Extension-Instance
 48:      *
 49:      * Contains:
 50:      * - Do 3rdParty Setup
 51:      * - Create new (internal) 3rdParty Instance
 52:      *
 53:      * @return \MOC\Generic\Device\Extension
 54:      */
 55:     public function Create();
 56: 
 57:     /**
 58:      * Set external Extension-Instance
 59:      *
 60:      * Contains:
 61:      * - Set new (external created) 3rdParty Instance to Current
 62:      *
 63:      * @param $Instance
 64:      *
 65:      * @return \MOC\Generic\Device\Extension
 66:      */
 67:     public function Define( $Instance );
 68: 
 69:     /**
 70:      * Select Index as active 3rdParty Instance
 71:      *
 72:      * @param int $Index
 73:      *
 74:      * @return \MOC\Generic\Device\Extension
 75:      */
 76:     public function Select( $Index );
 77: 
 78:     /**
 79:      * Get Index for Select() from Current() 3rdParty Instance
 80:      *
 81:      * @return int
 82:      */
 83:     public function Index();
 84: 
 85:     /**
 86:      * Get active 3rdParty Instance
 87:      *
 88:      * @return Object
 89:      */
 90:     public function Current();
 91: 
 92:     /**
 93:      * Destroy active 3rdParty Instance
 94:      *
 95:      * @return \MOC\Generic\Device\Extension
 96:      */
 97:     public function Destroy();
 98: 
 99: }
100: