SGSetSoundInputDriver
Some sound channel components may use sound input devices to obtain their source data. The SGSetSoundInputDriver function allows you to assign a sound input device to a sound channel.
pascal ComponentResult SGSetSoundInputDriver (SGChannel c,
const Str255 driverName);
c
- Specifies the reference that identifies the channel for this operation. You obtain this reference from the
SGNewChannel function, described on page 5-29.
driverName
- Specifies the name of the sound input device. This is a Pascal string, and it must correspond to a valid sound input device.
DESCRIPTION
If the sound channel component does not use sound input devices, it returns a nonzero result code. For more information about sound input devices, see Inside Macintosh: More Macintosh Toolbox--in particular, refer to the discussion of the Sound Manager's SPBGetIndexedDevice routine.
SPECIAL CONSIDERATIONS
You cannot call the SGSetSoundInputDriver function during a record operation.
RESULT CODES
| noDeviceForChannel | -9400 | Channel component cannot find its device |
| cantDoThatInCurrentMode | -9402 | Request invalid in current mode |
| deviceCantMeetRequest | -9408 | Device cannot support grabber |
