Inside Macintosh: Sound /

Chapter 3 - Sound Input Manager / Sound Input Manager Reference

Sound Input Manager Routines / Recording Sounds Directly From Sound Input Devices

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 macro	Selector
_SoundDispatch	$02300014

RESULT CODES

noErr	0	No error
siBadSoundInDevice	-221	Invalid sound input device