From: AN Long <aisk@users.noreply.github.com>
Date: Sun, 16 Mar 2025 15:27:24 +0000 (+0900)
Subject: gh-131327: Document winsound.SND_APPLICATION (#131328)
X-Git-Tag: v3.14.0a7~365
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=bf4c1bf344ed1f80c4e8f4fd5b1a8f0e0858777e;p=thirdparty%2FPython%2Fcpython.git

gh-131327: Document winsound.SND_APPLICATION (#131328)

Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
---

diff --git a/Doc/library/winsound.rst b/Doc/library/winsound.rst
index f7ca9dc57bbe..799fb3dea195 100644
--- a/Doc/library/winsound.rst
+++ b/Doc/library/winsound.rst
@@ -135,6 +135,13 @@ provided by Windows platforms.  It includes functions and several constants.
       This flag is not supported on modern Windows platforms.
 
 
+.. data:: SND_APPLICATION
+
+   The *sound* parameter is an application-specific alias in the registry.
+   This flag can be combined with the :const:`SND_ALIAS` flag
+   to specify an application-defined sound alias.
+
+
 .. data:: MB_ICONASTERISK
 
    Play the ``SystemDefault`` sound.
diff --git a/PC/winsound.c b/PC/winsound.c
index 094c77ae34d6..1cb42f2f3bdf 100644
--- a/PC/winsound.c
+++ b/PC/winsound.c
@@ -56,6 +56,7 @@ PyDoc_STRVAR(sound_module_doc,
 "SND_NODEFAULT - Do not play a default beep if the sound can not be found\n"
 "SND_NOSTOP - Do not interrupt any sounds currently playing\n"  // Raising RuntimeError if needed
 "SND_NOWAIT - Return immediately if the sound driver is busy\n" // Without any errors
+"SND_APPLICATION - sound is an application-specific alias in the registry."
 "\n"
 "Beep(frequency, duration) - Make a beep through the PC speaker.\n"
 "MessageBeep(type) - Call Windows MessageBeep.");