Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Utility Functions for Video Channel Callback Functions

SGGrabCompressComplete

The SGGrabCompressComplete function provides the default behavior for your grab-compress-complete function.

pascal ComponentResult SGGrabCompressComplete (SGChannel c, 
                                             Boolean *done, 
                                             SGCompressInfo *ci, 
                                             TimeRecord *tr);

c

Identifies the channel for this operation. The sequence grabber provides this value to your grab-compress-complete function.

done

Contains a pointer to a Boolean value. The SGGrabCompressComplete function sets this value to true when it is done; it sets it to false if the operation is incomplete. The sequence grabber provides this pointer to your grab-compress-complete function.

ci

Contains a pointer to a compression information structure. When the operation is complete, the SGGrabCompressComplete function fills in this structure with information about the compression operation. The format and content of this structure are discussed earlier in this chapter, beginning on page 5-20.

The sequence grabber provides this pointer to your grab-compress-complete function.

tr

Contains a pointer to a time record. When the operation is complete, the SGGrabCompressComplete function uses this structure to indicate when the frame was grabbed. The format and content of this structure are discussed in the chapter "Movie Toolbox" in Inside Macintosh: QuickTime.

The sequence grabber provides this pointer to your grab-compress-complete function.

SPECIAL CONSIDERATIONS

You should call the SGGrabCompressComplete function only from your grab-compress-complete function. If you call it at other times, results are unpredictable.

RESULT CODE

cantDoThatInCurrentMode

-9402

Request invalid in current mode

SEE ALSO

See "Application-Defined Functions" beginning on page 5-107 for information about grab-compress-complete functions.

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