Yurttas/PL/SL/python/docs/core-python-programming/doc/152/lib/module-winsound.html

From ZCubes Wiki
Revision as of 18:39, 7 November 2013 by MassBot1 (talk | contribs) (Created page with "<div class="navigation"> {| width="100%" cellspacing="2" align="center" | yurttas/PL/SL/python/docs/core-python-programming/doc/152/lib/undoc.html|[[Image:yurttas_PL_SL...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

18.2 winsound -- Sound-playing interface for Windows

Availability: Windows.

New in version 1.5.2.

The winsound module provides access to the basic sound-playing machinery provided by Windows platforms. It includes a single function and several constants.

PlaySound (sound, flags)
Call the underlying PlaySound() function from the Platform API. The sound parameter may be a filename, audio data as a string, or None. Its interpretation depends on the value of flags, which can be a bit-wise ORed combination of the constants described below. If the system indicates an error, RuntimeError is raised.
SND_FILENAME
The sound parameter is the name of a WAV file.
SND_ALIAS
The sound parameter should be interpreted as a control panel sound association name.
SND_LOOP
Play the sound repeatedly. The SND_ASYNC flag must also be used to avoid blocking.
SND_MEMORY
The sound parameter to PlaySound() is a memory image of a WAV file. Note: This module does not support playing from a memory image asynchonously, so a combination of this flag and SND_ASYNC will raise a RuntimeError.
SND_PURGE
Stop playing all instances of the specified sound.
SND_ASYNC
Return immediately, allowing sounds to play asynchronously.
SND_NODEFAULT
If the specified sound cannot be found, do not play a default beep.
SND_NOSTOP
Do not interrupt sounds currently playing.
SND_NOWAIT
Return immediately if the sound driver is busy.

Send comments on this document to python-docs@python.org.