Miles Sound System SDK 7.2a

AIL_open_input

The function AIL_open_input opens a digital input channel (usually from the microphone) to receive input digital audio data.

HDIGINPUT AIL_open_input(
  AIL_INPUT_INFO *info
);

Out Parameters

info: points to a structure of type AIL_INPUT_INFO. The info structure contains the details of the digital audio input to perform.

Returns

A handle to the new input handle, or NULL if the open failed.

Discussion

The Miles Sound System uses the waveIn API for input.

Recording doesn't begin until you call the AIL_set_input_state function.

There are two types of sound drivers under Windows - half-duplex and full-duplex. Half-duplex means that you can either play audio or record audio, but not at the same time. Full-duplex means that you can play and record audio simultaneously. There are virtually no sound cards available any more that don't have full-duplex drivers available (although they sometimes must be switched to full-duplex in the Control Panel), so you will usually just want to require full-duplex drivers.

If, however, you want to support half-duplex driver, then you must use switch between playing and recording using logic somewhat like this:

To record audio: call AIL_digital_handle_release, call AIL_open_input, start recording.

To play audio again: call AIL_close_input, call AIL_digital_handle_reacquire, starting playing again.

On MacOS, recording is always perform in full-duplex mode. You should select a device in "Sound Monitoring" pop-up in the "Monitor and Sound" control panel.

Group: Digital Audio Input (Recording) Services
Related Functions: AIL_close_input, AIL_digital_handle_reacquire, AIL_digital_handle_release, AIL_get_input_info, AIL_open_input, AIL_set_input_state
Related Basic Types: HDIGINPUT, MSS_PLATFORM_PROPERTY
Related Structures: AIL_INPUT_INFO