Software Driver Naming Convention. ADLINK Technology PCI-7200

5.3 Software Driver Naming Convention

The functions of PCI-7200's software drivers are using full-names to represent the functions' real meaning. The naming convention rules are :

Ÿ

DOS

_{hardware_model}_{action_name}. e.g. _7200_Initial ().

Ÿ

Windows 95/98

In order to recognize the difference between DOS library and

Windows library, A capital "W" is put on the head of each function name of the Windows DLL driver. e.g. W_7200_Initial ()

There are 21 function calls provided by each driver for PCI-7200

Digital I/O cards; all drivers (DOS, Win-95/98) provide the same function capability. The function names using in Windows is only a capital "W" put on the head of each function name of DOS library.

The detailed descriptions of each function are specified in the following sections.

5.4 _7200_Initial

@ Description

A PCI-7200 card is initialized according to the card number.

Because the PCI-7200 is PCI bus architecture and meets the plug and play design, the IRQ and base_address ( pass-through address) are assigned by system BIOS directly. Every PCI-7200 card has to be initialized by this function before calling other functions.

36

••

C/C++ & DLL Libraries

@ Syntax

Visual C++ (Windows 95/98) int W_7200_Initial (U8 card_number, U16 *base_addresss, U8

*irq_no)

Visual Basic (Windows 95/98)

W_7200_Initial (ByVal card_number As Byte, base_addresss As

Integer, irq_no As Byte) As Long

C/C++ (DOS) int _7200_Initial (U8 card_number, U16 *base_addresss, U8

*irq_no)

@ Argument

card_number : the card number to be initialized, only four cards can be initialized, the card number must be

CARD_1, CARD_2, CARD_3 or CARD_4.

base_address : the I/O port base address of the card, it is assigned by system BIOS.

irq_no : system will give an available interrupt number to this card automatically.

@ Return Code

ERR_NoError

ERR_InvalidBoardNumber

ERR_PCIBiosNotExist

ERR_PCICardNotExist

ERR_PCIIrqNotExist

ERR_BaseAddressError

C/C++ & DLL Libraries

••

37