SGPause
You can suspend or restart a record or preview operation by calling the SGPause function. You supply a byte value that instructs the sequence grabber whether to pause or restart the current operation.
pascal ComponentResult SGPause (SeqGrabComponent s,
Byte pause);
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.
pause
- Instructs the sequence grabber whether to suspend or restart the current operation. The following values are valid:
seqGrabUnpause
- Restarts the current operation.
seqGrabPause
-
Pauses the current operation.
seqGrabPauseForMenu
-
Pauses the current operation so that you may display a menu. Use this option only in preview mode, just before you call the Menu Manager's MenuSelect or PopUpMenuSelect function. In this case, the sequence grabber may not pause all channels, depending upon the ability of the sequence grabber to play with acceptable quality. For example, sound channels may continue to play while video channels are paused.
DESCRIPTION
The SGPause function does not release any system resources or temporary memory associated with the current operation. Consequently, it is generally much faster than using the SGStop and SGStartRecord functions or the SGStartPreview function to suspend an operation.
SPECIAL CONSIDERATIONS
When you restart the operation, the sequence grabber component may be unable to satisfy your request. This can occur, for example, if the user has moved the display window to a location that the digitizing hardware cannot support.
RESULT CODES
| cantDoThatInCurrentMode | -9402 | Request invalid in current mode |
| notEnoughMemoryToGrab | -9403 | Insufficient memory for record operation |
| deviceCantMeetRequest | -9408 | Device cannot support grabber |
File Manager errors
Memory Manager errors
SEE ALSO
You may determine whether the sequence grabber is paused by calling the SGGetPause function, which is described next.
