SGIdle
The SGIdle function provides processing time to the sequence grabber component and its channel components. After starting a preview or record operation, you should call this function as often as possible, until you stop the operation by calling SGStop.
- WARNING
- If you do not call
SGIdle frequently enough, you may lose data.
pascal ComponentResult SGIdle (SeqGrabComponent s);
s
- Specifies the component instance that identifies your connection to the sequence grabber component. You obtain this value from the Component Manager's
OpenDefaultComponent or OpenComponent function.
DESCRIPTION
The SGIdle function reports several status and error conditions by means of its result code. If you have established a time limit for a record operation by calling the SGSetMaximumRecordTime function (described on page 5-51), SGIdle returns a result code of grabTimeComplete when the time limit expires. In addition, SGIdle reports errors that are specific to the channels that are active for a given operation. If SGIdle returns a nonzero result code during a record operation, you should still call the SGStop function (described on page 5-38) so that the sequence grabber can store the data it has collected.
RESULT CODES
| grabTimeComplete | -9401 | Time for record operation has expired |
| cantDoThatInCurrentMode | -9402 | Request invalid in current mode |
File Manager errors
Memory Manager errors