mirror of
				https://github.com/alsa-project/alsa-lib.git
				synced 2025-11-03 09:01:52 -05:00 
			
		
		
		
	alsa-lib - added pcm_errors section
This commit is contained in:
		
							parent
							
								
									f032a8cf3f
								
							
						
					
					
						commit
						36eb137f69
					
				
					 1 changed files with 23 additions and 0 deletions
				
			
		| 
						 | 
				
			
			@ -259,6 +259,29 @@ See the #snd_pcm_mmap_readi(),
 | 
			
		|||
#snd_pcm_writei(), #snd_pcm_readn()
 | 
			
		||||
and #snd_pcm_writen() functions.
 | 
			
		||||
 | 
			
		||||
\section pcm_errors Error codes
 | 
			
		||||
 | 
			
		||||
\par -EPIPE
 | 
			
		||||
 | 
			
		||||
This error means xrun (underrun for playback or overrun for capture).
 | 
			
		||||
The underrun can happen when an application does not feed new samples
 | 
			
		||||
in time to alsa-lib (due CPU usage). The overrun can happen when
 | 
			
		||||
an application does not take new captured samples in time from alsa-lib.
 | 
			
		||||
 | 
			
		||||
\par -ESTRPIPE
 | 
			
		||||
 | 
			
		||||
This error means that system has suspended drivers. The application
 | 
			
		||||
should wait in loop when snd_pcm_resume() != -EAGAIN and then
 | 
			
		||||
call snd_pcm_prepare() when snd_pcm_resume() return an error code.
 | 
			
		||||
If snd_pcm_resume() does not fail (a zero value is returned), driver
 | 
			
		||||
supports resume and the snd_pcm_prepare() call can be ommited.
 | 
			
		||||
 | 
			
		||||
\par -EBADFD
 | 
			
		||||
 | 
			
		||||
This error can happen when device is physically removed (for example
 | 
			
		||||
some hotplug devices like USB or PCMCIA, CardBus or ExpressCard
 | 
			
		||||
can be removed on the fly).
 | 
			
		||||
 | 
			
		||||
\section pcm_params Managing parameters
 | 
			
		||||
 | 
			
		||||
The ALSA PCM device uses two groups of PCM related parameters. The hardware
 | 
			
		||||
| 
						 | 
				
			
			
 | 
			
		|||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue