Measurement Computing Personal488 rev.3.0 For DOS & Windows 3.Xi User Manual

Page 339

Advertising
background image

15B. Driver488/SUB, W31, W95, & WNT

III. COMMAND REFERENCES - 15. Command References

III-324

Personal488 User’s Manual, Rev. 3.0

Driver488 provides additional

EnterI

routines that are short form versions of the

EnterXI

function.

The additional

EnterI

functions are:

EnterI

,

EnterNI

,

EnterMoreI

, and

EnterNMoreI

. These

functions are discussed in detail below:

EnterNI

SYNTAX

EnterNI(ByVal devHandle%,data%,By Val count& ) As Long

REMARKS

EnterNI

is equivalent to the following call to

EnterXI

:

EnterXI(devHandle%,data%,count&, 1, 0, 0, 0)

The

EnterNI

function passes the device handle, the pointer to the data buffer, and the size of the data

buffer to the

EnterXI

function. It specifies

forceAddr%

is

TRUE

, causing Driver488 to re-address the

device. The default terminators are chosen by specifying a

0

pointer as the

term

parameter.

Asynchronous transfer is turned off by sending

0

for the

async%

parameter, and the completion status

value is ignored by sending

0

for the

compStat%

parameter.

EnterNMoreI

SYNTAX

EnterNMoreI(ByVal devHandle%,data%,ByVal count&)As Long

REMARKS

EnterNMoreI

is equivalent to the following call to

EnterXI

:

EnterXI(devHandle%,data%,count&,0,0,0,0);

The

EnterNMoreI

function passes the device handle, the pointer to the data buffer, and the size of the

data buffer to the

EnterXI

function. It specifies

forceAddr%

is

FALSE

; therefore, Driver488 does not

address the device if it is the same device as previously used. The default terminators are chosen by
specifying a

0

as the

term

parameter. Asynchronous transfer is turned off by sending

0

for the

async%

parameter, and the completion status value is ignored by sending

0

for the

compStat%

parameter.

Note:

All forms of the

EnterI

commands (except

EnterXI

) use

EOI

as the only terminator. Also,

EnterI

and

EnterMoreI

must be passed to the entire array (i.e.

intarray()

, not the

starting location:

intarray (0)

).

The following table describes the differences between the various forms of

EnterI

. It outlines the

variables passed to each function and how many bytes the functions read.

EnterI Function

Reads Until

Variable

EnterXI (ADC,IResp (0),1000,1,Term,1,1)

n

bytes or

terminators

Pass starting location

EnterI (ADC, IResp())
EnterMoreI (ADC, IResp ())

Array full or

EOI

Pass entire array

EnterNI (ADC< IResp (0), 1000)
EnterNMoreI (ADC, IResp (0), 1000)

n

bytes or

EOI

Pass starting location

where:

SResp

is

String * 1000

, and

IResp(1000)

is

integer

.

Advertising