mirror of
				https://github.com/alsa-project/alsa-lib.git
				synced 2025-11-03 09:01:52 -05:00 
			
		
		
		
	pcm: fix the documentation for snd_pcm_poll_descriptors again
As noted in the github issue, the poll descriptors may change depending
on the stream parameters.
Fixes: cd04da2b ("pcm: clarify documentation of poll descriptor usage")
Fixes: https://github.com/alsa-project/alsa-lib/issues/372
Signed-off-by: Jaroslav Kysela <perex@perex.cz>
			
			
This commit is contained in:
		
							parent
							
								
									60d6fad711
								
							
						
					
					
						commit
						d4992c36cc
					
				
					 1 changed files with 4 additions and 3 deletions
				
			
		| 
						 | 
					@ -1812,9 +1812,10 @@ static int __snd_pcm_poll_descriptors(snd_pcm_t *pcm, struct pollfd *pfds,
 | 
				
			||||||
 * \link ::snd_pcm_poll_descriptors_revents() \endlink .
 | 
					 * \link ::snd_pcm_poll_descriptors_revents() \endlink .
 | 
				
			||||||
 *
 | 
					 *
 | 
				
			||||||
 * It is guaranteed that for the given PCM handle, the output poll
 | 
					 * It is guaranteed that for the given PCM handle, the output poll
 | 
				
			||||||
 * descriptor structs (and their count) will never change, thus it is
 | 
					 * descriptor structs (and their count) will not change after
 | 
				
			||||||
 * valid to call the function once and reuse its output for the
 | 
					 * hardware and software parameters setup. Thus it is valid to call
 | 
				
			||||||
 * lifetime of the PCM device.
 | 
					 * the function once when all parameters are set and reuse its output
 | 
				
			||||||
 | 
					 * for the lifetime of the stream parameters.
 | 
				
			||||||
 *
 | 
					 *
 | 
				
			||||||
 * The function is thread-safe when built with the proper option.
 | 
					 * The function is thread-safe when built with the proper option.
 | 
				
			||||||
 */
 | 
					 */
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue