viAssertIntrSignal

NI-VISA

viAssertIntrSignal

Purpose

Asserts the specified interrupt or signal.

C Syntax

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

Visual Basic Syntax

viAssertIntrSignal&(ByVal vi&, ByVal mode%, ByVal statusID&)

Resource Classes

GPIB-VXI BACKPLANE, VXI BACKPLANE, VXI SERVANT

Parameters

Name Direction Description

vi

IN

Unique logical identifier to a session.

mode

IN

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

statusID

IN

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

Return Values

Completion Codes Description

VI_SUCCESS

Operation completed successfully.

 

Error Codes Description

VI_ERROR_INV_OBJECT

The given session reference is invalid.

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.

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_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.

Description

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. The following table lists the valid values for the mode parameter.

Mode Action Description

VI_ASSERT_USE_ASSIGNED

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

VI_ASSERT_SIGNAL

Send the notification via a VXI signal.

VI_ASSERT_IRQ1 - VI_ASSERT_IRQ7

Send the interrupt via the specified 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.

Related Topics

BACKPLANE Resource

SERVANT Resource

viAssertUtilSignal