GtDio6xStepCopySettingsToSteps

GX5296, GX5961, GX5964, File

Copies the specified step settings to a list of steps.

GtDio6xStepCopySettingsToSteps (nHandle, lSourceStep, lStepCount, palStepList, dwOptions, pnStatus)

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.
lSourceStep	LONG	Source step to copy settings from, step number 0-4095.
lStepCount	LONG	Used to specify the number of steps to set. This parameter should not be greater than the size of palChannelListArray.
palStepList	PLONG	Array containing steps numbers that will be set by this function, steps numbers are 0-based.
dwOptions	DWORD	Options can be ORed. 0. GTDIO6X_COPY_SETTINGS_ALL: copy all the settings from the source step. 1. GTDIO6X_COPY_SETTINGS_NO_VECTOR: copy all the settings from the source step without vector settings. 2. GTDIO6X_COPY_SETTINGS_NO_TSET_INDEX: copy all the settings from the source step without timing set Index settings. 4. GTDIO6X_COPY_SETTINGS_NO_JUMP_STEP: copy all the settings from the source step without jump step settings.
pnStatus	PSHORT	Returned status: 0 on success, negative number on failure.

This function copies the source step settings to the list of steps.

The following example inserts 10 steps and then copies step 0 settings to all other steps:

SHORT nStatus;

LONG alStepList[10];

INT I;

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

for (i=1; i<10; i++)

alStepList[i]=i;

GtDio6xStepCopySettingsToSteps(nHandle, 0, 10, alStepList, GTDIO6X_COPY_SETTINGS_ALL, &nStatus);