Previous Book Contents Book Index Next

Inside Macintosh: Sound /
Chapter 3 - Sound Input Manager / Sound Input Manager Reference
Sound Input Manager Routines / Recording Sounds Directly From Sound Input Devices


Legacy Documentclose button

Important: Inside Macintosh: Sound is deprecated as of Mac OS X v10.5. For new audio development in Mac OS X, use Core Audio. See the Audio page in the ADC Reference Library.

SPBStopRecording

You can use the SPBStopRecording function to end a recording from a sound input device.

FUNCTION SPBStopRecording (inRefNum: LongInt): OSErr;
inRefNum
The device reference number of the sound input device, as obtained from the SPBOpenDevice function.
DESCRIPTION
The SPBStopRecording function stops recording from the device specified by the inRefNum parameter. The recording must be asynchronous for SPBStopRecording to have any effect. When you call SPBStopRecording, the sound input completion routine specified in the completionRoutine field of the sound input parameter block is called and the error field of that parameter block is set to abortErr. If you are writing a device driver, you will receive a KillIO Status call. See the section "Writing a Sound Input Device Driver" beginning on page 3-13 for more information.

SPECIAL CONSIDERATIONS
You can call the SPBStopRecording function at interrupt time.

ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for the SPBStopRecording function are
Trap macroSelector
_SoundDispatch$02300014

RESULT CODES
noErr0No error
siBadSoundInDevice-221Invalid sound input device

Previous Book Contents Book Index Next

© Apple Computer, Inc.
2 JUL 1996