Causes a transition to the Committed state. This VI verifies property values, reserves the device, and commits the property values to the device. If the property values are all valid, NI-FGEN sets the device hardware configuration to match the session configuration.

In the Committed state, waveforms, scripts, and sequences can be loaded into memory. If any properties are changed, NI-FGEN implicitly transitions back to the Idle state. This VI has no effect if the device is already in the Committed or Generating states, and returns a successful status value.

Calling this VI before the niFgen Initiate Generation VI is optional but has several benefits:

  • Routes are committed, so signals are exported or imported.
  • Any reference clock and external clock circuits are phase-locked.
  • A subsequent niFgen Initiate Generation can run faster because the device is already configured.


icon

Inputs/Outputs

  • civrn.png Instrument Handle —

    Instrument Handle identifies a particular instrument session.

    Instrument Handle is obtained from the niFgen Initialize VI, niFgen Initialize With Options VI, or the niFgen Initialize With Channels VI.

  • cerrcodeclst.png error in (no error) —

    error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

    Default value: no error

  • iivrn.png Instrument Handle Out —

    Instrument Handle Out passes a reference to your instrument session to the next VI.

  • ierrcodeclst.png error out —

    error out contains error information. This output provides standard error out functionality.