National Instruments NI-VXI

Chapter 3 Software Overview

NI-VXI User Manual 3-2 © National Instruments Corporation

CloseVXIlibrary ()

CloseVXIlibrary is the application termination routine, which

must be included at the end (or abort) of any application.

CloseVXIlibrary disables interrupts and frees dynamic memory

allocated for the internal RM table and other structures. You must

include a call to CloseVXIlibrary at the termination of your

application (for whatever reason) to free all data structures allocated

by InitVXIlibrary and disable interrupts. Failure to call

CloseVXIlibrary when terminating your application can cause

unpredictable and undesirable results. If your application can be

aborted from some operating system abort routine (such as a break key

or a process kill signal), be certain to install an abort/close routine to

call CloseVXIlibrary.

CreateDevInfo (la)

CreateDevInfo creates a new entry in the dynamic NI-VXI RM table

for the specified logical address. It installs default NULL values into the

entry. You must use one of the SetDevInfo functions after this point

to change any of the device information as needed. This operation is

not needed for VME devices since it is recommended that you use the

Non-VXI Device Editor in the VXIedit or VXItedit NI-VXI

resource editor utility. At the startup of your application,

InitVXIlibrary completely initializes the RM table to how the RM

configured the VXI system. No initial changes/creations are necessary

for VXI devices. You can use CreateDevInfo to add non-VXI

devices or pseudo-devices (future expansion).

FindDevLA (namepat, manid, modelcode, devclass, slot,

mainframe, cmdrla, la)

FindDevLA scans the RM table information for a device with the

specified attributes and returns its VXI logical address. You can use

any combination of attributes to specify a device. A -1 (negative one)

or "" specifies to ignore the corresponding field in the attribute

comparison. After finding the VXI logical address, you can use one of

the GetDevInfo functions to get any information about the specified

device.