GX5296, GX5961, GX5964, File
Sets the Step’s vector count and address.
GtDio6xStepSetVectorCount (nHandle, lStep, lVectorAddress, lVectorCount, 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. |
lStep |
LONG |
Step Number to access 0-4095. |
lVectorAddress |
LONG |
Used to set the offset into Vector Memory associated with a step.GX5961, GX5964:The offset can be from 0 to 262143. Multiple steps can be assigned to the same pattern offset.Note: The address must be a multiple of 4.GX5296:The offset can be from 0 to 67108863. Multiple steps can be assigned to the same pattern offset. |
lVectorCount |
LONG |
Used to set the number of Vectors associated with a Step.GX5961, GX5964:The number of vector s can be from 1 vector up to 262144.GX5296:The number of vector s can be from 1 vector up to 67108864. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative value on failure. |
A Step contains a pointer to a range of Vectors represented in terms of a Vector Count (number of Vectors) and a starting Vector Address. These vectors will be executed when the Step is run by the Sequencer. Different steps can have over lapping Vector ranges.
This function assigns a vector set for the specified step. Assigning a pattern set consists of specifying the number of vectors and a beginning offset. The vectors are stored in the vector memory.
The following example sets Step 4’s vector count to 1000 and vector address to 0, and returns the settings:
LONG lVectorCount, lVectorOffset;
SHORT nStatus;
GtDio6xStepSetVectorCount(nHandle, 4, 0, 1000, &nStatus);
GtDio6xStepGetVectorCount(nHandle, 4, &lVectorOffset, &lVectorCount, &nStatus);