Added ommited clear() functions

This commit is contained in:
Jaroslav Kysela 2002-10-12 12:04:08 +00:00
parent 8205a95376
commit 170a5d0d7b

View file

@ -382,14 +382,14 @@ Using standalone, it is a light method to obtain current stream position,
because it does not require the user <-> kernel context switch, but the value
is less accurate, because ring buffer pointers are updated in kernel drivers
only when an interrupt occurs. If you want to get accurate stream state,
use functions \link ::snd_pcm_avail \endlink or \link ::snd_pcm_delay \endlink.
use functions \link ::snd_pcm_hwsync \endlink or \link ::snd_pcm_delay \endlink.
Note that both of these functions do not update the current r/w pointer
for applications, so the function \link ::snd_pcm_avail_update \endlink must
be called afterwards before any read/write begin+commit operations.
<p>
The function \link ::snd_pcm_avail \endlink returns current available space
in the ring buffer. Note that this function does not update the current r/w
pointer for applications, so the function \link ::snd_pcm_avail_update \endlink
The function \link ::snd_pcm_hwsync \endlink reads the current hardware pointer
in the ring buffer from hardware. Note that this function does not update the current
r/w pointer for applications, so the function \link ::snd_pcm_avail_update \endlink
must be called afterwards before any read/write/begin+commit operations.
<p>
The function \link ::snd_pcm_delay \endlink returns the delay in samples.
@ -2777,6 +2777,16 @@ void snd_pcm_hw_params_free(snd_pcm_hw_params_t *obj)
free(obj);
}
/**
* \brief clear snd_pcm_hw_params_t structure
* \param obj pointer to structure
*/
void snd_pcm_hw_params_clear(snd_pcm_hw_params_t *obj)
{
assert(obj);
memset(obj, 0, snd_pcm_hw_params_sizeof());
}
/**
* \brief copy one #snd_pcm_hw_params_t to another
* \param dst pointer to destination
@ -4911,6 +4921,16 @@ void snd_pcm_sw_params_free(snd_pcm_sw_params_t *obj)
free(obj);
}
/**
* \brief clear snd_pcm_sw_params_t structure
* \param obj pointer to structure
*/
void snd_pcm_sw_params_clear(snd_pcm_sw_params_t *obj)
{
assert(obj);
memset(obj, 0, snd_pcm_sw_params_sizeof());
}
/**
* \brief copy one #snd_pcm_sw_params_t to another
* \param dst pointer to destination
@ -5331,6 +5351,16 @@ void snd_pcm_status_free(snd_pcm_status_t *obj)
free(obj);
}
/**
* \brief clear snd_pcm_status_t structure
* \param obj pointer to structure
*/
void snd_pcm_status_clear(snd_pcm_status_t *obj)
{
assert(obj);
memset(obj, 0, snd_pcm_status_sizeof());
}
/**
* \brief copy one #snd_pcm_status_t to another
* \param dst pointer to destination
@ -5450,6 +5480,16 @@ void snd_pcm_info_free(snd_pcm_info_t *obj)
free(obj);
}
/**
* \brief clear snd_pcm_info_t structure
* \param obj pointer to structure
*/
void snd_pcm_info_clear(snd_pcm_info_t *obj)
{
assert(obj);
memset(obj, 0, snd_pcm_info_sizeof());
}
/**
* \brief copy one #snd_pcm_info_t to another
* \param dst pointer to destination