Chapter 3 Software Overview
NI-VXI User Manual 3-42 © National Instruments Corporation
SignalDeq (la, signalmask, signal)
SignalDeq retrieves signals from the global signal queue. Two
methods are available to handle VXI signals. You can handle the
signals either by handlers or by queueing on a global signal queue. The
RouteSignal function specifies which types of signals should be
handled by which of the two methods for each VXI logical address.
You can use SignalDeq to selectively dequeue a signal off of the
global signal queue. The signal specified by signalmask for the
specified logical address (la) is dequeued and returned in the output
parameter signal.
SignalEnq (signal)
SignalEnq places signals at the end of the global signal queue. You
can use SignalEnq within a signal handler to queue a signal or to
simulate the reception of a signal by placing a value on the global
signal queue that was not actually received as a signal.
SignalJam (signal)
SignalJam places signals at the front of the global signal queue.
SignalJam can be used to simulate the reception of a signal by
placing a value on the global signal queue that was not actually
received as a signal. Because SignalJam places signal values on the
front of the global signal queue, the signal is guaranteed to be the first
of its type to be dequeued.
Note: This function is intended only for debugging purposes.
WaitForSignal (la, signalmask, timeout, retsignal, retsignalmask)
WaitForSignal waits for the specified maximum amount of time for
a particular signal (or class of signals) to be received. Signalmask
defines the type(s) of signals that the application program waits for.
The timeout value specifies the maximum amount of time (in
milliseconds) to wait until the signal occurs. The signal that unblocks
the WaitForSignal call returns in the output parameter retsignal.
You should use the WaitForSignal function only when signals are
queued. A multitasking operating system lets you have any number of
WaitForSignal calls pending. A non-multitasking operating system
permits only one pending WaitForSignal call.