GpibChangeLocal

Function

In master mode (controller), transmits command that make slave device return to local mode (GTL) to slave device.

In slave mode (non-controller), make board specified by Device ID return to local.

Format

Ret = GpibChangeLocal ( Id )

Parameter

Id [ VB.NET: Short ][ C, C++: short ][ C#: short ]

When using DevID:

Specifies the address of slave device that transmits GTL to for listener in GpibSetAddrInfo function.

Specifies -1 for talker.

(Please use this when transmitting GTL command to plural slave devices at the same time)

When using EqpID:

Transmits GTL command to address of slave device specified in EqpID.

Return Value

Ret [ VB.NET: Integer ][ C, C++: long ][ C#: int ]

0	Normality completion
10001	Invalid ID was specified
10002	Driver can not be called
12871	Address specified in GpibSetAddrInfo is wrong
12890	Asynchronous function is running now
22891	Forcibly terminated by GpibStopAsync
22892	Terminates by forcible termination key
22894	TimeOut
22895	No connected device (GPIB error)
22897	Being used in other process

Initial Value

None

Remarks

Example

When using DevID:

Transmits GTL command to slave devices at the same time whose address is 1 and 2.

C	short Talker, ListenerArray[15]; Talker = -1; ListenerArray[0] = 1; ListenerArray[1] = 2; ListenerArray[2] = -1; Ret = GpibSetAddrInfo ( DevId, Talker, ListenerArray ); Ret = GpibChangeLocal ( DevId );

Makes board whose DevID is specified return to local.

C	short Talker, ListenerArray[15]; Talker = -1; ListenerArray[0] =- 1; Ret = GpibSetAddrInfo ( DevId, Talker, ListenerArray ); Ret = GpibChangeLocal ( DevId );

When using EqpID

Transmits GTL command to address of slave device specified in EqpID.

C	Ret = GpibChangeLocal ( EqpId );