# `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`.