Inside Macintosh: Apple Game Sprockets Guide /

Chapter 1 - SoundSprocket / SoundSprocket Reference

SoundSprocket Functions / Creating and Managing Listeners

SSpListener_GetMedium

You can use the SSpListener_GetMedium function to get the sound medium and relative humidity of a listener.

OSStatus SSpListener_GetMedium (
SSpListenerReference inListenerReference,
UInt32 *outMedium,
float *outHumidity);

inListenerReference

A listener reference.

outMedium

On exit, the current sound medium of the listener. See "Sound Media" (page 1-25) for a description of the available sound media.

outHumidity

On exit, the current relative humidity of the listener. Humidity is a floating-point value between 0.0 (indicating dry air) and 100.0 (indicating dense fog).

function result

A result code.

DESCRIPTION

The SSpListener_GetMedium function returns, in the outMedium and outHumidity parameters, the current sound medium and relative humidity of the listener specified by the inListenerReference parameter.