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.
Chapter 3 - Sound Input Manager
This chapter describes the Sound Input Manager, the part of the Macintosh system software that controls the recording of sound through sound input devices. You can use the Sound Input Manager to display and manage the sound recording dialog box. This ensures that the user is presented with a consistent and standard user interface for sound recording. You can, however, also use Sound Input Manager routines to record sound without the sound recording dialog box or to interact directly with a sound input device driver.To use this chapter, you should already be familiar with the information in the chapter "Introduction to Sound on the Macintosh" earlier in this book, and in particular with the portions of that chapter that concern sound recording. That chapter explains how your application can record either a sound resource or a sound file using the standard sound recording dialog box. You need to read this chapter only if you need to interact with the Sound Input Manager at a lower level than is allowed by the high-level functions
SndRecord
andSndRecordToFile
. For example, you need to read this chapter to learn how to
To use this chapter, you should also be familiar with the chapter "Sound Manager" in this book, especially the portions of that chapter that describe
- record sound without using the sound recording dialog box
- interact with a sound input device driver
- write a sound input device driver
If you are writing a sound input device driver, you should already be familiar with writing device drivers in general, as described in the book Inside Macintosh: Devices.
- the format of sampled-sound data
- the Macintosh Audio Compression and Expansion (MACE) routines
- the structure of sound resources and sound files
- the use of the
Gestalt
function to determine whether certain sound-related facilities are available.
Chapter Contents
- About the Sound Input Manager
- Sound Recording Without the Standard Interface
- Interaction With Sound Input Devices
- Sound Input Device Drivers
- Using the Sound Input Manager
- Recording Sounds Directly From a Device
- Defining a Sound Input Completion Routine
- Defining a Sound Input Interrupt Routine
- Getting and Setting Sound Input Device Information
- Writing a Sound Input Device Driver
- Responding to Status and Control Requests
- Responding to Read Requests
- Supporting Stereo Recording
- Supporting Continuous Recording
- Sound Input Manager Reference
- Constants
- Gestalt Selector and Response Bits
- Sound Input Device Information Selectors
- Data Structures
- Sound Input Parameter Blocks
- Sound Input Manager Routines
- Recording Sounds
- Opening and Closing Sound Input Devices
- Recording Sounds Directly From Sound Input Devices
- Manipulating Device Settings
- Constructing Sound Resource and File Headers
- Registering Sound Input Devices
- Converting Between Milliseconds and Bytes
- Obtaining Information
- Application-Defined Routines
- Sound Input Completion Routines
- Sound Input Interrupt Routines
- Summary of the Sound Input Manager
- Pascal Summary
- Constants
- Data Types
- Sound Input Manager Routines
- Application-Defined Routines
- C Summary
- Constants
- Data Types
- Sound Input Manager Routines
- Application-Defined Routines
- Assembly-Language Summary
- Data Structures
- Trap Macros
- Result Codes