Company Events Academic Community Support Solutions Products & Services Contact NI MyNI

Destroy Motion Reference

NI SoftMotion Module Help

Edition Date: August 2013

Part Number: 371093P-01

»View Product Info

Owning Palette: NI SoftMotion Module

Requires: NI SoftMotion Module Lite.

Destroys the NI SoftMotion interface reference. LabVIEW destroys existing motion references automatically when the top-level VI finishes running. However, National Instruments recommends that you destroy the motion reference explicitly, especially in a long-running application, to conserve memory resources. Details Examples

/images/reference/en-XX/help/371093P-01/cmclrn.gif motion handle is the NI SoftMotion interface object refnum.
error in describes error conditions that occur before this VI or function runs. This input provides standard error in functionality.

This node runs normally even if an error occurred before this node runs.
error out contains error information. This output provides standard error out functionality.

Details

LabVIEW automatically destroys all motion interface objects that are created with the Create Motion Reference VI when the top-level VI finishes running. However, National Instruments recommends that you destroy motion references explicitly with the Destroy Motion Reference VI, especially in a long-running application, to conserve memory resources. A motion resource reference remains in memory as long as the following conditions are met:

  • A top-level VI that is not idle owns a reference to it. If the top-level VI becomes idle, LabVIEW releases all motion resource references the VI owns, including references that exist in subVIs of the top-level VI. You cannot use a motion resource reference across multiple top-level VIs.
  • LabVIEW is running and the resource is deployed.
  • A top-level VI that is not idle owns a reference to it. If the top-level VI becomes idle, LabVIEW releases all motion resource references the VI owns, including references that exist in subVIs of the top-level VI. You cannot use a motion resource reference across multiple top-level VIs. You can manually destroy a motion interface reference by calling the Destroy Motion Reference VI.
  • The motion interface reference is open.

Examples

Refer to examples\Motion\PropertyNodes for examples using the Destroy Motion Reference VI.


 

Your Feedback! poor Poor  |  Excellent excellent   Yes No
 Document Quality? 
 Answered Your Question? 
Add Comments 1 2 3 4 5 submit