A base class providing methods for virtual device management.
    | 
       
     | 
      
        
          create(self,
        nDeviceType) 
      Create a new virtual device object not bound to any virtual machine. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          connect(self) 
      Connect a virtual device to a running virtual machine. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          disconnect(self) 
      Disconnect a device from a running virtual machine. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          create_image(self,
        bRecreateIsAllowed=False,
        bNonInteractiveMode=True) 
      Physically create a virtual device image on the host. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          | copy_image(self,
        sNewImageName,
        sTargetPath,
        nFlags) | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          resize_image(self,
        nNewSize,
        nFlags) 
      Resize the virtual device image. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          get_index(self) 
      Return the index identifying the virtual device. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_index(self,
        nIndex) 
      Set theindex identifying the virtual device. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          remove(self) 
      Remove the virtual device object from the parent virtual machine 
      list. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          get_type(self) 
      Return the virtual device type. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          is_connected(self) 
      Determine if the virtual device is connected. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_connected(self,
        bConnected) 
      Connect the virtual device. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          is_enabled(self) 
      Determine if the device is enabled. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_enabled(self,
        bEnabled) 
      Enable the specified virtual device. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          is_remote(self) 
      Determine if the virtual device is a remote device. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_remote(self,
        bRemote) 
      Change the 'remote' flag for the specified device. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          get_emulated_type(self) 
      Return the virtual device emulation type. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_emulated_type(self,
        nEmulatedType) 
      Sets the virtual device emulation type. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          get_image_path(self) 
      Return virtual device image path. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_image_path(self,
        sNewImagePath) 
      Set the virtual device image path. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          get_sys_name(self) 
      Return the virtual device system name. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_sys_name(self,
        sNewSysName) 
      Set the virtual device system name. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          get_friendly_name(self) 
      Return the virtual device user-friendly name. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_friendly_name(self,
        sNewFriendlyName) 
      Set the virtual device user-friendly name. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          get_description(self) 
      Return the description of a virtual device. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_description(self,
        sNewDescription) 
      Set the device description. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          get_iface_type(self) 
      Return the virtual device interface type (IDE or SCSI). | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_iface_type(self,
        nIfaceType) 
      Set the virtual device interface type (IDE or SCSI). | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
      
     | 
  
    | 
       
     | 
      
        
          | set_sub_type(self,
        nSubType) | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          get_stack_index(self) 
      Return the virtual device stack index (position at the IDE/SCSI 
      controller bus). | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_stack_index(self,
        nStackIndex) 
      Set the virtual device stack index (position at the IDE or SCSI 
      controller bus). | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_default_stack_index(self) 
      Generates a stack index for the device (the device interface, IDE or 
      SCSI, must be set in advance). | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          get_output_file(self) 
      Return the virtual device output file. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_output_file(self,
        sNewOutputFile) 
      Set the virtual device output file. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          is_passthrough(self) 
      Determine if the passthrough mode is enabled for the mass storage 
      device. | 
          
            
            
           | 
         
       
      
     | 
  
    | 
       
     | 
      
        
          set_passthrough(self,
        bPassthrough) 
      Enable the passthrough mode for the mass storage device (optical or 
      hard disk). | 
          
            
            
           | 
         
       
      
     | 
  
  
    | 
     Inherited from _Handle:
      __del__,
      __init__,
      add_ref,
      free,
      from_string,
      get_handle_type,
      get_package_id,
      reg_event_handler,
      unreg_event_handler
       
    Inherited from object:
      __delattr__,
      __format__,
      __getattribute__,
      __hash__,
      __new__,
      __reduce__,
      __reduce_ex__,
      __repr__,
      __setattr__,
      __sizeof__,
      __str__,
      __subclasshook__
       
     |