SPBGetIndexedDevice

Returns the name and icon of a device

#include <Sound.h> Sound Manager

OSErr SPBGetIndexedDevice( count, deviceRefNum, deviceIconHandle);

short count; a device index number

Str255 deviceName; the name of the sound input device

Handle * deviceIconHandle; a handle to memory contianing an icon

returns Error Code; 0=no error

The SPBGetIndexedDevice function returns the name and icon of the device

whose index is specified in the count parameter.

count a device index number. Your application can create a list of sound

input devices by calling this function with a count starting at 1 and

incrementing until the function returns siBadSoundInDevice.

deviceName specifies this device's name. On completion, the deviceName

parameter contains a string that is the name of the device

deviceIconHandle is a handle to a block of memory in your application's heap

containing the device's icon. The SPBGetIndexedDevice function

allocates this memory for you, but it is your responsibility to

dispose of that handle when you are finished with it

Returns: an operating system Error Code.

noErr (0) No error

siBadSoundInDevice (-221) Invalid sound input device

Notes: You cannot call SPBGetIndexedDevice at interrupt time

Referenced by (7):