Closevxilibrary (), Createdevinfo (la), Closevxilibrary -2 createdevinfo -2 finddevla -2 – National Instruments NI-VXI User Manual

Page 40

Advertising
background image

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.

Advertising