libao documentation

libao version 0.8.0 - 20010804

ao_open_live

declared in "ao/ao.h";

Open a live playback audio device for output.


ao_device* ao_open_live(int driver_id, ao_sample_format *format, ao_option *options);

Parameters

driver_id
The ID number of the driver as returned by either ao_driver_id() or ao_default_driver_id().
format
Pointer to a struct describing the sample format. The caller retains ownership of this structure.
options
A linked list of options to be passed to the driver or NULL if no options are needed. Unsupported options are ignored.

Return Values

  • non-NULL pointer inicates success. This pointer must be passed in subsequent calls to ao_play() and ao_close().
  • NULL indicates failure. errno will contain the specific cause of the failure:
  • Notes

    File output drivers cannot be used with this function. Use ao_open_file() instead.


    copyright © 2001 Stan Seibert

    xiph.org
    indigo@aztec.asu.edu

    libao documentation

    libao version 0.8.0 - 20010804