Destroy Motion Reference

LabVIEW 2018 SoftMotion Module

Edition Date: March 2018

Part Number: 371093W-01

»View Product Info
Download Help (Windows Only)

Owning Palette: SoftMotion Module

Destroys the 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/371093W-01/cmclrn.gif motion handle is the 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.

    Note Note  Destroying a SoftMotion Reference while trying to perform an operation on that reference can result in unexpected behaviour.

Examples

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

WAS THIS ARTICLE HELPFUL?

Not Helpful