Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Controlling Sequence Grabber Components

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

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help