|This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.|
Read pending mixer events
#include <sys/asoundlib.h> int snd_mixer_read( snd_mixer_t *handle, snd_mixer_callbacks_t *callbacks );
- The handle for the mixer device. This must have been created by snd_mixer_open().
- A pointer to a snd_mixer_callbacks_t structure that defines the list of callbacks.
The snd_mixer_read() function reads pending mixer events from the mixer handle. As each event is read, the list of callbacks is checked for a handler for this event. If a match is found, the callback is invoked. This function is usually called when the select() library call indicates that there is data to be read on the mixer's file descriptor.
The number of events read from the handle, or a negative value on error.
- Invalid file descriptor. Your handle may be corrupt.
- The read operation was interrupted by a signal, and either no data was transferred, or the resource manager responsible for that file doesn't report partial transfers.
- An event I/O error occurred.