X-Git-Url: http://de.git.xonotic.org/?a=blobdiff_plain;f=snd_main.h;h=d2e37f39051b49b14596894895870383b25953c6;hb=56561de0acdb9cf29d155992440ac3e0d32909dd;hp=d9ecb0c66d7c2c403130b92d54d809c05e1f04b8;hpb=d50445e9045ddea0d49857346597c57c129029e0;p=xonotic%2Fdarkplaces.git

diff --git a/snd_main.h b/snd_main.h
index d9ecb0c6..d2e37f39 100644
--- a/snd_main.h
+++ b/snd_main.h
@@ -43,6 +43,7 @@ typedef struct
 #define SFXFLAG_FILEMISSING		(1 << 0) // wasn't able to load the associated sound file
 #define SFXFLAG_SERVERSOUND		(1 << 1) // the sfx is part of the server precache list
 #define SFXFLAG_STREAMED		(1 << 2) // informative only. You shouldn't need to know that
+#define SFXFLAG_PERMANENTLOCK	(1 << 3) // can never be freed (ex: used by the client code)
 
 typedef struct snd_fetcher_s snd_fetcher_t;
 struct sfx_s
@@ -50,9 +51,11 @@ struct sfx_s
 	char				name[MAX_QPATH];
 	sfx_t				*next;
 	mempool_t			*mempool;
-	unsigned int		locks;			// A locked sfx_t must not be freed.
-										// Locks are added by S_PrecacheSound and S_ServerSounds.
-										// SFX can be freed by S_UnlockSfx or S_ServerSounds.
+	int					locks;			// One lock is automatically granted while the sfx is
+										// playing (and removed when stopped). Locks can also be
+										// added by S_PrecacheSound and S_ServerSounds.
+										// A SFX with no lock and no SFXFLAG_PERMANENTLOCK is
+										// freed at level change by S_ServerSounds.
 	unsigned int		flags;			// cf SFXFLAG_* defines
 	snd_format_t		format;
 	int					loopstart;
@@ -111,6 +114,9 @@ void SNDDMA_Shutdown(void);
 qboolean S_LoadSound (sfx_t *s, qboolean complain);
 void S_UnloadSound(sfx_t *s);
 
+void S_LockSfx (sfx_t *sfx);
+void S_UnlockSfx (sfx_t *sfx);
+
 void *S_LockBuffer(void);
 void S_UnlockBuffer(void);