NewSequenceFile Method
Syntax
Engine.NewSequenceFile
Return Value
Purpose
Creates and returns a new SequenceFile object.
Remarks
Call the Engine.ReleaseSequenceFileEx method on this object before you release it.
This method stores the new sequence file in the engine's internal cache and adds a load reference to the sequence file. TestStand uses the load reference count to determine when to unload the sequence file from the engine's internal cache. In addition to this method, the SequenceFile.AddLoadReference and Engine.GetSequenceFileEx methods also add a load reference to the sequence file. The Engine.ReleaseSequenceFileEx method removes a load reference.
You must call Engine.ReleaseSequenceFileEx for each load reference you add to the sequence file. When you release the last load reference, TestStand unloads the file from the engine's internal cache. While unloading the file from the engine's internal cache, TestStand executes the SequenceFileUnload callback, if applicable.