Inside Macintosh: Sound /

Chapter 3 - Sound Input Manager / Sound Input Manager Reference

Sound Input Manager Routines / Registering Sound Input Devices

SPBSignOutDevice

You can use the SPBSignOutDevice function to cancel the registration of a device you have previously registered with the SPBSignInDevice function.

FUNCTION SPBSignOutDevice (deviceRefNum: Integer): OSErr;

deviceRefNum

The driver reference number of the device you wish to sign out.

DESCRIPTION

The SPBSignOutDevice function cancels the registration of the device whose driver reference number is deviceRefNum; the device is unregistered from the Sound Input Manager's list of available sound input devices and no longer appears in the Sound In control panel.

Ordinarily, you should not need to use the SPBSignOutDevice function. You might use it if your device driver detects that a sound input device is not functioning correctly or has been disconnected.

SPECIAL CONSIDERATIONS

Because the SPBSignOutDevice function moves or purges memory, you should not call it at interrupt time.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the SPBSignOutDevice function are

Trap macro	Selector
_SoundDispatch	$01100014

RESULT CODES

noErr	0	No error
siBadSoundInDevice	-221	Invalid sound input device
siDeviceBusyErr	-227	Sound input device is busy