GtDio6xStepInsert

Applies To

GX5296, GX5961, GX5964, File

Purpose

Inserts new step.

Syntax

GtDio6xStepInsert (nHandle, nMode, lStep,lNumOfSteps, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Session identifier:

     Board handle is used when communicating with the hardware. The Board handle session identifier is returned by calling GtDio6xInitialize or GtDio6xSetupInitialization.

     File handle is used when communicating with a file. The File handle session identifier is  returned by calling GtDio6xFileOpen.

nMode
SHORT
Insert mode:

0.  GTDIO6X_INSERT_STEP_AT: insert the specified number of new steps at the current step number.

1.  GTDIO6X_INSERT_STEP_AFTER insert the specified number of new steps after the current step number.

2.  GTDIO6X_INSERT_AFTER_LAST_STEP: insert the specified number of new steps after last.

lStep
LONG
Specify the step number to insert at, step number to insert, step numbers are 0-4095.
lNumOfSteps  
LONG
Number of steps to add.
pnStatus
PSHORT
Returned status: 0 on success, negative value on failure.

Comments

This function insert new default steps as follows:

TimingSet Index =0

Phase Trigger Source = GTDIO6X_PHASE_TRIGGER_SOURCE_SYSTEM_CLOCK

Period = 100nSec

Clocks Per Vector = 1

Step Vector Count = 1

Step Last flag= FALSE

Step Conditional

Subroutine Return = FALSE

Step Pause and Resume sources = GTDIO6X_PAUSE_TRIGGER_DISABLED

Pause Resume Trigger = GTDIO6X_PAUSE_RESUME_DISABLED

Record = Mode = GTDIO6X_STEP_RECORD_MODE_DISABLED

Output Flag 0 = GTDIO6X_STEP_OUTPUT_FLAG_LOW

Output Flag 1 = GTDIO6X_STEP_OUTPUT_FLAG_LOW

Timeout Mode = GTDIO6X_STEP_TIMEOUT_MODE_PER_STEP

Conditional Jumping = GTDIO6X_CONTROL_ACTION_NONE

Loop Count = 0

Loop Counter = 0

Example

The following example inserts 10 steps and then delete 3 steps starting at step 7:

 

SHORT nStatus;

GtDio6xStepInsert(nHandle, GTDIO6X_INSERT_STEP_AT, 1, 10,  &nStatus);

GtDio6xStepDelete (nHandle, 7, 3, FALSE, &nStatus);

 

See Also

GtDio6xGetErrorString