itrigger

  • Supported sessions: device, interface
  • Affected by functions: ilock, itimeout

C Syntax

#include <sicl.h>
int itrigger (id);
INST id;

Visual Basic Syntax

(Windows only)

Function itrigger (ByVal id As Integer)

Description

The itrigger function is used to send a trigger to a device.

Triggers on GPIB

GPIB Device Session Triggers

The itrigger function performs an addressed GPIB group execute trigger (GET).

GPIB Interface Session Triggers

The itrigger function performs an unaddressed GPIB group execute trigger (GET). The itrigger command on a GPIB interface session should be used in conjunction with igpibsendcmd.

Triggers on RS-232 (Serial)

RS-232 Device Session Triggers

The itrigger function sends the IEEE-488.2 *TRG\n command to the serial device.

RS-232 Interface Session Triggers

The itrigger function performs the same function as calling ixtrig with the I_TRIG_STD value passed to it: it pulses the DTR modem control line.

VXI Triggers

(Windows only)

VXI Device Session Triggers

The itrigger function sends a word-serial trigger to the specified device. The itrigger function is only supported on message-based device sessions with VXI.

VXI Interface Session Triggers

The itrigger function performs the same function as calling ixtrig with the I_TRIG_STD value passed to it: it causes one or more VXI trigger lines to fire. Trigger lines fired are determined by the ivxitrigroute function.

VXI is only supported in the Windows product.

Return Value

For C programs, this function returns zero (0) if successful,or a non-zero error number if an error occurs. For Visual Basic programs, no error number is returned. Instead, the global Err variable is set if an error occurs.

See Also

ixtrig