api: introduce PA_VOLUME_MAX

diff --git a/src/pulse/volume.h b/src/pulse/volume.h
index c3c396c8dc364e113840e8114a794eaf796e0e92..5b7e1213701917ab4658a189f6be1dcd783125d0 100644 (file)
--- a/src/pulse/volume.h
+++ b/src/pulse/volume.h
@@ -24,6 +24,7 @@
 ***/
 
 #include <inttypes.h>
+#include <limits.h>
 
 #include <pulse/cdecl.h>
 #include <pulse/gccmacro.h>
@@ -102,12 +103,15 @@ PA_C_DECL_BEGIN
  * > PA_VOLUME_NORM: increased volume */
 typedef uint32_t pa_volume_t;
 
-/** Normal volume (100%) */
+/** Normal volume (100%, 0 dB) */
 #define PA_VOLUME_NORM ((pa_volume_t) 0x10000U)
 
-/** Muted volume (0%) */
+/** Muted volume (0%, -inf dB) */
 #define PA_VOLUME_MUTED ((pa_volume_t) 0U)
 
+/** Maximum volume we can store. \since 0.9.15 */
+#define PA_VOLUME_MAX ((pa_volume_t) UINT32_MAX)
+
 /** A structure encapsulating a per-channel volume */
 typedef struct pa_cvolume {
     uint8_t channels;                     /**< Number of channels */