device configuration

The following sections define the various devices for the player. Unless you really know what to do you should not change the following options. As most entries are similar only some educational examples are listed here. For a complete reference have a look at your personal cp.ini file for details.

The general form of a device looks like:

[handle]
  link=...                                  
  subtype=...                               
  port=...                                  
  port2=...                                 
  irq=...                                   
  irq2=...                                  
  dma=...                                   
  dma2=...                                  
  bypass=...                                
  keep=...

handle

The internal name to use within the player. The cp.ini file must contain all handles listed in the devices options of the devices section.

link

the name of the dll function this device will be linked to.

port(2)

the primary/secondary port of the sound card. This value has to be given in hexadecimal with preceeding 0x or appending h!

irq(2)

the primary/secondary IRQ of the sound card

dma(2)

the primary/secondary DMA channel of the card

bypass

skip the autodetection if it may encounter problems

keep

keep the driver resident in memory, even it is not currently needed.

Most device functions of the standard dll contain autodetection routines for the supported sound cards, so there is normally no need to specify any of the port, irq or dma options. However if OPENCP is not able to detect your sound cards settings you can try to insert the appropriate values in the configuration file.

The next subsections will look at the special features the different sound cards and drivers support. The original order of the cp.ini has been slightly modified for the purpose of documentation.