background image

ICON

TYPE

PARAMETER

VALUE TO  SET,  COMMENTS

niSE Connect And Disconnect 

(continued)

NISEInt32

multiconnectMode

• USE_DEFAULT_MODE (–1)
• NO_MULTICONNECT (0) 
• MULTICONNECT_ROUTES (1)

NISEInt32

operationOrder

• BREAK_BEFORE_MAKE (1)
• BREAK_AFTER_MAKE (2)

NISEBoolean

waitForDebounce

• NISE_TRUE
• NISE_FALSE

NISESession

sessionHandle

Reference to virtual device session

NISEConstString

disconnectSpec

String describing the 

disconnections to be made

NISESession

sessionHandle

Reference to virtual device session

NISESession

sessionHandle

Reference to virtual device session

NISEConstString

channel 1

Channel name of one of the end 

points of the route to find

NISEConstString

channel 2

Channel name of one of the end 

points of the route to find

NISEBuffer* [out]

routeSpec

Returns the path between the 

channels if PATH_EXISTS or 
PATH_AVAILABLE

NISEInt32 * [in/out]

routeSpecSize

• Input = size of the route string 

buffer being passed

• Return = the size required to hold 

the entire route string

NISEInt32 * [out]

routeCapability

• PATH_AVAILABLE (1) 
• PATH_EXISTS (2)
• PATH_UNSUPPORTED (3) 
• RSRC_IN_USE (4)
• SOURCE_CONFLICT (5)
• CHANNEL_NOT_AVAILABLE (6)
• CHANNELS_HARDWIRED (7)

Functions continued on the next page

niSE Find Route

(niSE_FindRoute)

Finds an existing or potential route between channel 1 and channel 2.

niSE Disconnect All

(niSE_DisconnectAll)

Disconnects all connections on every IVI switch device managed by the
NISE session reference passed to this function. 

niSE Disconnect

(niSE_Disconnect)

Disconnects the routes specified in the disconnection specification.

3

NI Switch Executive Quick Reference Guide

©

National Instruments Corporation

323249d.qxp  7/22/2004  4:39 PM  Page 3

Summary of Contents for Switch Executive

Page 1: ...ath between two channels and then connects the path Sequenced Connect And Disconnect Uses Connect and Disconnect to sequence through different switching system states Route Specification Syntax Exampl...

Page 2: ...to be made niSE Connect And Disconnect niSE_ConnectAndDisconnect Connects the routes specified by the connection specification When connecting it may allow for multiconnection based on the multiconnec...

Page 3: ...to find NISEBuffer out routeSpec Returns the path between the channels if PATH_EXISTS or PATH_AVAILABLE NISEInt32 in out routeSpecSize Input size of the route string buffer being passed Return the siz...

Page 4: ...ecent error NISESession sessionHandle Reference to virtual device session NISEStatus out errorNumber Returns the error number of the first error that occurred in the session since the error was last c...

Page 5: ...y a forward slash delimiter For example device iviChan Note Any channel other than an endpoint within a route specification string must be reserved for routing or directly hardwired to one of the endp...

Page 6: ...ing contains invalid characters or could not be understood EVAL_TIMED_OUT FFFF8EAF 29008 NI Switch Executive is running with an evaluation license and the time limit for this session has expired Resta...

Page 7: ...E_ALREADY_EXISTS FFFF8EA2 29021 The route you are trying to connect or a route with the same endpoints is already connected ROUTE_EXISTS_AS_UNSHAREABLE FFFF8EA1 29022 The route you are trying to conne...

Page 8: ...RDER FFFF8E9A 29030 Invalid operation order CONFIG_CHANNEL_CONFLICT FFFF8E99 29031 A reserved for routing channel required for connecting this route is already in use by another route SOURCE_CHANNEL_C...

Reviews: