viAssertIntrSignal

Agilent VISA.NET

viAssertIntrSignal

Syntax

viAssertIntrSignal(ViSession vi, ViInt16 mode, ViUInt32 statusID);

Description

Asserts the specified device interrupt or signal. This operation can be used to assert a device interrupt condition. In VXI, for example, this can be done with either a VXI signal or a VXI interrupt. On certain bus types, the statusID parameter may be ignored.

Note: This function is not implemented in Agilent VISA.

Parameters

Name

Dir

Type

Description

vi

IN

ViSession

Unique logical identifier to a session.

mode

IN

ViInt16

This specifies how to assert the interrupt. See the Description section for actual values.

statusID

IN

ViUInt32

This is the status value to be presented during an interrupt acknowledge cycle.

Special Values for mode Parameter

mode

Action Description

VI_ASSERT_IRQ1 - VI_ASSERT_IRQ7

VXI/VME IRQ line. This uses the standard VXI/VME ROAK (release on acknowledge) interrupt mechanism rather than the older VME RORA (release on register access) mechanism.

VI_ASSERT_SIGNAL

Send the notification via a VXI signal.

VI_ASSERT_USE_ASSIGNED

Use whatever notification method that has been assigned to the local device.

Return Values

Type ViStatus

This is the function return status. It returns either a completion code or an error code as follows.

Completion Code

Description

VI_SUCCESS

Operation completed successfully.

Error Codes

Description

VI_ERROR_BERR

Bus error occurred during transfer.

VI_ERROR_INTR_PENDING

An interrupt is still pending from a previous call.

VI_ERROR_INV_MODE

The value specified by the mode parameter is invalid.

VI_ERROR_INV_SESSION
VI_ERROR_INV_OBJECT

The given session or object reference is invalid (both are the same value).

VI_ERROR_NSUP_INTR

The interface cannot generate an interrupt on the requested level or with the requested statusID value.

VI_ERROR_NSUP_MODE

The specified mode is not supported by this VISA implementation.

VI_ERROR_NSUP_OPER

The given vi does not support this operation.

VI_ERROR_RSRC_LOCKED

Specified operation could not be performed because the resource identified by vi has been locked for this kind of access.

See Also

 BACKPLANE resource description