GetDriverModule Procedure

Returns the module number of the specified Driver's name, sDriverName.

Syntax

[ nModule = ] GetDriverModule ( [ sDriverName ] )

The GetDriverModule procedure syntax has the following parts:

 

Name

Type

Description

nModule

Short

Module number

sDriverName

Val BString

Configuration name of a Driver

Comments

Note: This function is provided only for compatibility with ATEasy 2 users.

Some instruments use special addressing called module. These instruments may be VXI switching systems with one master card and several slave cards that have no address and are identified by a module number. To add the module number, first add a parameter entry of Number type called Module in the Driver Parameters page. Then enter the module number in the Driver Shortcut Misc page.

In ATEasy 2, base addresses of PC-based instruments are also specified as a module number. In ATEasy 3, the address can be specified in the Driver Interface Property page, under the ISA Interface.

The function returns -1 if sDriverName cannot be found or Module parameter was not defined. It returns 0 if no value is specified as a module number in the Driver shortcut Property page.

Example

If a 'Relay' Driver is configured as a VXI instrument and module number 2 (of a switch matrix device) was set, the following will result in nMod=2:

nMod = GetDriverModule("Relay")

See Also

ADriver, ADriver.ModuleType, ASystem, Driver Variable, GetDriverAddress, GetDriverName, GetDriverType, Interfaces, PortOutByte