"winsound" --- Interfaz de reproducción de sonido para Windows
**************************************************************

======================================================================

El modulo "winsound" permite acceder a la maquinaria básica de
reproducción de sonidos proporcionada por la plataformas Windows.
Incluye funciones y varias constantes.

winsound.Beep(frequency, duration)

   Hace sonar el altavoz del PC. El parámetro *frequency* especifica
   la frecuencia, en hercio (hz), de la señal de audio y debe estar en
   el rango de 37 a 32.767 hz. El parámetro *duration* especifica el
   numero de milisegundo de duración de la señal de audio. Si el
   sistema no puede hacer sonar el altavoz, se lanza "RuntimeError".

winsound.PlaySound(sound, flags)

   Call the underlying "PlaySound()" function from the Platform API.
   The *sound* parameter may be a filename, a system sound alias,
   audio data as a *bytes-like object*, or "None".  Its interpretation
   depends on the value of *flags*, which can be a bitwise ORed
   combination of the constants described below. If the *sound*
   parameter is "None", any currently playing waveform sound is
   stopped. If the system indicates an error, "RuntimeError" is
   raised.

winsound.MessageBeep(type=MB_OK)

   Call the underlying "MessageBeep()" function from the Platform API.
   This plays a sound as specified in the registry.  The *type*
   argument specifies which sound to play; possible values are "-1",
   "MB_ICONASTERISK", "MB_ICONEXCLAMATION", "MB_ICONHAND",
   "MB_ICONQUESTION", and "MB_OK", all described below.  The value
   "-1" produces a "simple beep"; this is the final fallback if a
   sound cannot be played otherwise.  If the system indicates an
   error, "RuntimeError" is raised.

winsound.SND_FILENAME

   El parámetro *sound* es el nombre de un archivo WAV. No lo uses con
   "SND_ALIAS".

winsound.SND_ALIAS

   El parámetro *sound* es un nombre de asociación de sonido del
   registro.  Si el registro no contiene tal nombre, reproduce el
   sonido por defecto del sistema a menos que "SND_NODEFAULT" también
   se especifique. Si no se registra ningún sonido por defecto, se
   lanza "RuntimeError". No lo uses con "SND_FILENAME".

   Todos los sistemas Win32 soportan al menos lo siguiente; la mayoría
   de los sistemas soportan muchos más:

   +----------------------------+------------------------------------------+
   | "PlaySound()" *name*       | Panel de control correspondiente nombre  |
   |                            | (*name*) del sonido                      |
   |============================|==========================================|
   | "'SystemAsterisk'"         | Asterisco                                |
   +----------------------------+------------------------------------------+
   | "'SystemExclamation'"      | Exclamación                              |
   +----------------------------+------------------------------------------+
   | "'SystemExit'"             | Salir de Windows                         |
   +----------------------------+------------------------------------------+
   | "'SystemHand'"             | Parada crítica                           |
   +----------------------------+------------------------------------------+
   | "'SystemQuestion'"         | Pregunta                                 |
   +----------------------------+------------------------------------------+

   Por ejemplo:

      import winsound
      # Play Windows exit sound.
      winsound.PlaySound("SystemExit", winsound.SND_ALIAS)

      # Probably play Windows default sound, if any is registered (because
      # "*" probably isn't the registered name of any sound).
      winsound.PlaySound("*", winsound.SND_ALIAS)

winsound.SND_LOOP

   Reproducir el sonido repetidamente.  El flag "SND_ASYNC" también
   debe ser usada para evitar el bloqueo.  No puede ser usada con
   "SND_MEMORY".

winsound.SND_MEMORY

   El parámetro *sound* de "PlaySound()" es una imagen de memoria de
   un archivo WAV, como un *bytes-like object*.

   Nota:

     Este módulo no admite la reproducción desde una imagen de memoria
     de forma sincrónica, por lo que una combinación de este indicador
     y "SND_ASYNC" se lanza "RuntimeError".

winsound.SND_PURGE

   Detiene la reproducción de todas las instancias de un sonido
   específico.

   Nota:

     Esta flag no esta soportado en las plataformas modernas de
     Windows.

winsound.SND_ASYNC

   Retorna inmediatamente, permitiendo que los sonidos se reproduzcan
   asincrónicamente.

winsound.SND_NODEFAULT

   Si no se puede encontrar el audio especificado, no reproduce el
   sonido predeterminado del sistema.

winsound.SND_NOSTOP

   No interrumpe los sonidos que se están reproduciendo.

winsound.SND_NOWAIT

   Retorna inmediatamente en caso de que  el controlador de sonido
   está ocupado.

   Nota:

     Esta flag no esta soportado en las plataformas modernas de
     Windows.

winsound.MB_ICONASTERISK

   Reproduce el sonido "SystemDefault".

winsound.MB_ICONEXCLAMATION

   Reproduce el sonido "SystemExclamation".

winsound.MB_ICONHAND

   Reproduce el sonido "SystemHand".

winsound.MB_ICONQUESTION

   Reproduce el sonido "SystemQuestion".

winsound.MB_OK

   Reproduce el sonido "SystemDefault".
