From: Jaroslav Kysela <perex@perex.cz>
Date: Thu, 10 Apr 2008 07:46:10 +0000 (+0200)
Subject: PCM API - explain more trigger timestamp
X-Git-Tag: v1.0.17rc1~7
X-Git-Url: https://git.alsa-project.org/?a=commitdiff_plain;h=d4250517f014f4f14d25a2b37e6ae07f07d49c31;p=alsa-lib.git

PCM API - explain more trigger timestamp
---

diff --git a/src/pcm/pcm.c b/src/pcm/pcm.c
index efabf5c3..a30d319a 100644
--- a/src/pcm/pcm.c
+++ b/src/pcm/pcm.c
@@ -5882,6 +5882,10 @@ snd_pcm_state_t snd_pcm_status_get_state(const snd_pcm_status_t *obj)
  * \brief Get trigger timestamp from a PCM status container
  * \param obj #snd_pcm_status_t pointer
  * \param ptr Pointer to returned timestamp
+ *
+ * Trigger means a PCM state transition (from stopped to running or
+ * versa vice). It applies also to pause and suspend. In other words,
+ * timestamp contains time when stream started or when it was stopped.
  */
 void snd_pcm_status_get_trigger_tstamp(const snd_pcm_status_t *obj, snd_timestamp_t *ptr)
 {
@@ -5894,6 +5898,10 @@ void snd_pcm_status_get_trigger_tstamp(const snd_pcm_status_t *obj, snd_timestam
  * \brief Get trigger hi-res timestamp from a PCM status container
  * \param obj #snd_pcm_status_t pointer
  * \param ptr Pointer to returned timestamp
+ *
+ * Trigger means a PCM state transition (from stopped to running or
+ * versa vice). It applies also to pause and suspend. In other words,
+ * timestamp contains time when stream started or when it was stopped.
  */
 #ifndef DOXYGEN
 void INTERNAL(snd_pcm_status_get_trigger_htstamp)(const snd_pcm_status_t *obj, snd_htimestamp_t *ptr)