viUnmapTrigger
Purpose
Undo a previous map from the specified trigger source line to the specified destination line.
C Syntax
ViStatus viUnmapTrigger(ViSession vi, ViInt16 trigSrc, ViInt16 trigDest)
Visual Basic Syntax
viUnmapTrigger& (ByVal vi&, ByVal trigSrc%, ByVal trigDest%)
Resource Classes
GPIB-VXI BACKPLANE, PXI BACKPLANE, VXI BACKPLANE
Parameters
| Name | Direction | Description |
|---|---|---|
|
vi |
IN |
Unique logical identifier to a session. |
|
trigSrc |
IN |
Source line used in previous map. Refer to the Description section for actual values. |
|
trigDest |
IN |
Destination line used in previous map. Refer to the Description section for actual values. |
Return Values
| Completion Codes | Description |
|---|---|
|
VI_SUCCESS |
The operation completed successfully and the END indicator was received (for interfaces that have END indicators). |
| 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_INV_LINE |
One of the specified lines (trigSrc or trigDest) is invalid. |
|
VI_ERROR_TRIG_NMAPPED |
The path from trigSrc to trigDest is not currently mapped. |
|
VI_ERROR_NSUP_LINE |
One of the specified lines (trigSrc or trigDest) is not supported by this VISA implementation. |
Description
This operation can be used to undo a previous mapping of one trigger line to another. This operation is valid only on BACKPLANE (mainframe) sessions.
Special Values for trigSrc Parameter
| Value | Action Description |
|---|---|
|
VI_TRIG_TTL0 - VI_TRIG_TTL7 |
Unmap the specified VXI TTL trigger line. |
|
VI_TRIG_ECL0 - VI_TRIG_ECL1 |
Unmap the specified VXI ECL trigger line. |
|
VI_TRIG_PANEL_IN |
Unmap the controller's front panel trigger input line. |
|
VI_TRIG_PANEL_OUT |
Unmap the controller's front panel trigger output line. |
Special Values for trigDest Parameter
| Value | Action Description |
|---|---|
|
VI_TRIG_TTL0 - VI_TRIG_TTL7 |
Unmap the specified VXI TTL trigger line. |
|
VI_TRIG_ECL0 - VI_TRIG_ECL1 |
Unmap the specified VXI ECL trigger line. |
|
VI_TRIG_PANEL_IN |
Unmap the controller's front panel trigger input line. |
|
VI_TRIG_PANEL_OUT |
Unmap the controller's front panel trigger output line. |
|
VI_TRIG_ALL |
Unmap all trigger lines to which trigSrc is currently connected. |
This operation unmaps only one trigger mapping per call. In other words, if viMapTrigger() was called multiple times on the same BACKPLANE Resource and created multiple mappings for either trigSrc or trigDest, trigger mappings other than the one specified by trigSrc and trigDest should remain in effect after this call completes.
Related Topics