niHSDIO_CommitDynamic

Specific Function

C Function Prototype

ViStatus niHSDIO_CommitDynamic (ViSession vi);

Purpose

Programs the hardware for the dynamic data operation using the attributes you select. Before entering the committed state, most attribute values are stored in software only; these values have not yet been programmed to the hardware. Once the session is committed, the hardware is configured.

For many operations it is not necessary to explicitly call this function because the following functions implicitly commit:

• niHSDIO_Initiate
• niHSDIO_WriteScript
• Read Waveform functions
• Write Named Waveform functions

Start the operation with niHSDIO_Initiate. Running this function while a dynamic operation is in progress returns an error. Committing only programs attributes changed since previous commits.

Note  Committing some attributes may have immediate effects seen on external instrument connectors. Voltage levels are an example of an attribute with an immediate effect when committed.

Before committing a session that requires an external clock, ensure the external clock is available. Otherwise you receive an error that the device could not find or lock to the external clock.

Parameters

Return Value