Inside Macintosh: Telephony /

Chapter 2 - Telephone Terminals / Telephone Terminals Reference

Telephone Terminals Functions / Managing Sound Input Drivers and Sound Output Components

TELGetHSSoundInput

Gets the name of the current sound input driver.

pascal TELErr TELGetHSSoundInput (TELHandle termHand, Str255 deviceName);

termHand

A handle to a telephone record associated with a telephone terminal.

deviceName

On exit, a pointer to a Pascal-style string containing the name of the sound input driver for the specified telephone handset.

function result

A result code.

DESCRIPTION

The TELGetHSSoundInput function returns, in the deviceName parameter, a pointer to a Pascal-style string that contains the name of the sound input driver for the telephone handset specified by the termHand parameter.

SPECIAL CONSIDERATIONS

You should call TELDisposeHSSoundInput after you've called TELGetHSSoundInput; failure to do so will cause any subsequent calls to TELGetHSSoundInput to fail.

SEE ALSO

You can dispose of the sound input driver by calling TELDisposeHSSoundInput (next).