viMapTrigger
This section contains information specific to the Windows product.
Syntax
viMapTrigger(ViSession vi, ViInt16 trigSrc, ViInt16 trigDest, ViUInt16 mode);
Description
Map the specified trigger source line to the specified destination line. This operation can be used to map one trigger line to another. This operation is valid only on Backplane (BACKPLANE) sessions.
If this operation is called multiple times on the same BACKPLANE resource with the same source trigger line and different destination trigger lines, the result should be that when the source trigger line is asserted all specified destination trigger lines should also be asserted.
If this operation is called multiple times on the same BACKPLANE resource with different source trigger lines and the same destination trigger line the result should be that when any of the specified source trigger lines is asserted, the destination trigger line should also be asserted.
However, mapping a trigger line (as either source or destination) multiple times requires special hardware capabilities and is not guaranteed to be implemented.
Mapping one trigger line to another modifies the state of hardware. Therefore, the effect continues beyond the scope of the VISA session that mapped it, even if that VISA session is closed.
Parameters
|
Name |
Dir |
Type |
Description |
|---|---|---|---|
|
vi |
IN |
ViSession |
Unique logical identifier to a session. |
|
trigSrc |
IN |
ViInt16 |
Source line from which to map. |
|
trigDest |
IN |
ViInt16 |
Destination line to which to map. |
|
mode |
IN |
ViUInt16 |
Specifies the trigger mapping mode. This should always be VI_NULL for VISA 3.0 and later. |
Special Values for trgSrc and trigDest Parameters |
|||
|
Value |
|
|
Action Description |
|
VI_TRIG_ECL0 - VI_TRIG_ECL1 |
|
|
Map the specified VXI ECL trigger line. |
|
VI_TRIG_PANEL_IN |
|
|
Map the controller's front panel trigger input line. |
|
VI_TRIG_PANEL_OUT |
|
|
Map the controller's front panel trigger output line. |
|
VI_TRIG_STAR_SLOT1 - VI_TRIG_STAR_SLOT12 |
|
|
Map the specified STAR input trigger line. |
|
VI_TRIG_STAR_VXI0 - VI_TRIG_STAR_VXI2 |
|
|
Map the specified STAR trigger output line. |
|
VI_TRIG_TTL0 - VI_TRIG_TTL11 |
|
|
Map the specified TTL trigger line. |
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. |
|
VI_SUCCESS_TRIG_MAPPED |
The path from trigSrc to trigDest is already mapped. |
|
Error Code |
Description |
|
VI_ERROR_INV_LINE |
One of the specified lines (trigSrc or trigDest) is invalid. |
|
VI_ERROR_INV_MODE |
The value specified by the mode parameter is invalid. |
|
VI_ERROR_INV_SESSION |
The given session or object reference is invalid (both are the same value). |
|
VI_ERROR_LINE_IN_USE |
One of the specified lines (trigSrc or trigDest) is currently in use. |
|
VI_ERROR_NSUP_LINE |
One of the specified lines (trigSrc or trigDest) 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. |
|
VI_ERROR_TMO |
viMapAddress could not acquire resource or perform mapping before the timer expired. |
See Also
BACKPLANE Resource Description