mirrors/alsa-lib
1
0
Fork 0
mirror of https://github.com/alsa-project/alsa-lib.git synced 2025-11-03 09:01:52 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

Next documentation update for file descriptor routines

Browse source
This commit is contained in:
Jaroslav Kysela 2004-04-05 17:59:34 +00:00
parent e5ea2a6acd
commit b0ad5bf718
1 changed files with 11 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

12
src/pcm/pcm.c
View file

@ -1226,7 +1226,12 @@ int snd_pcm_poll_descriptors_count(snd_pcm_t *pcm)
* call, use \link ::snd_pcm_poll_descriptors_revents() \endlink function. * call, use \link ::snd_pcm_poll_descriptors_revents() \endlink function.
* The field values in pollfd structs may be bogus regarding the stream * The field values in pollfd structs may be bogus regarding the stream
* direction from the application perspective (POLLIN might not imply read * direction from the application perspective (POLLIN might not imply read
* direction and POLLOUT might not imply write). * direction and POLLOUT might not imply write), but
* the \link ::snd_pcm_poll_descriptors_revents() \endlink function
* does the right "demangling".
*
* You can use output from this function as arguments for the select()
* syscall, too.
*/ */
int snd_pcm_poll_descriptors(snd_pcm_t *pcm, struct pollfd *pfds, unsigned int space) int snd_pcm_poll_descriptors(snd_pcm_t *pcm, struct pollfd *pfds, unsigned int space)
{ {
@ -1258,6 +1263,11 @@ int snd_pcm_poll_descriptors(snd_pcm_t *pcm, struct pollfd *pfds, unsigned int s
* *
* This function does "demangling" of the revents mask returned from * This function does "demangling" of the revents mask returned from
* the poll() syscall to correct semantics (POLLIN = read, POLLOUT = write). * the poll() syscall to correct semantics (POLLIN = read, POLLOUT = write).
*
* Note: The null event also exists. Even if poll() or select()
* syscall returned that some events are waiting, this function might
* return empty set of events. In this case, application should
* do next event waiting using poll() or select().
*/ */
int snd_pcm_poll_descriptors_revents(snd_pcm_t *pcm, struct pollfd *pfds, unsigned int nfds, unsigned short *revents) int snd_pcm_poll_descriptors_revents(snd_pcm_t *pcm, struct pollfd *pfds, unsigned int nfds, unsigned short *revents)
{ {