Obtain Notifier
Returns a reference to a notifier.
Use this reference when calling other Notifier Operations functions.
 |
name contains the name of the notifier that you want to obtain or create. The default is an empty string to create an unnamed notifier. | ||||||
 |
element data type is the type of data that you want the notifier to contain. You can wire any data type to this input. | ||||||
 |
create if not found? specifies whether you want to create a new notifier if one with the same name as name does not exist. If TRUE (default), the function creates a notifier if one with the same name does not exist. | ||||||
 |
error in describes error conditions that occur before this VI or function runs.
The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
| ||||||
 |
notifier out is a reference to the existing named notifier or the new notifier created by this function. | ||||||
 |
created new? is TRUE if the function created a new notifier. | ||||||
 |
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces.
Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error.
|
Obtain Notifier Details
Use named notifiers to pass data between two sections of a block diagram or between two VIs. If you do not wire name, the function creates a new, unnamed notifier reference. If you wire name, the function first searches for an existing notifier with the same name and returns a new reference to the existing notifier. If a notifier with the same name does not already exist and create if not found? is TRUE, the function creates a new, named notifier reference.
If you use the Obtain Notifier function to return a reference to a named notifier inside a loop, LabVIEW creates a new reference to the named notifier each time the loop iterates. If you use Obtain Notifier in a tight loop, LabVIEW slowly increases how much memory it uses because each new reference uses an additional four bytes. These bytes are released automatically when the VI stops running. However, in a long-running application it may appear as if LabVIEW is leaking memory since the memory usage keeps increasing. To prevent this unintended memory allocation, use the Release Notifier function in the loop to release the notifier reference for each iteration.
This function might return error codes 1, 2, 1094, 1100, or 1492.
 | Note If you obtain a notifier reference in one application instance, you cannot use that notifier reference in another application instance. If you attempt to use a notifier reference in another application instance, LabVIEW returns error 1492. |
Examples
Refer to the following VIs for examples of using the Obtain Notifier function:
- General Notifier Example VI: labview\examples\general\notifier.llb
- Wait for All Notifications Demo VI: labview\examples\general\WaitForAll.llb
Resources
E-Mail this Page