Función MessageBeep (winuser.h)

  • Artículo

Reproduce un sonido de forma de onda. El sonido de forma de onda para cada tipo de sonido se identifica mediante una entrada en el registro.

 
Nota En Windows Server 2022, la tarea Microsoft\Windows\Multimedia\SystemSoundsService del Programador de tareas está deshabilitada. Esta tarea deberá habilitarse para que MessageBeep funcione.

Sintaxis

BOOL MessageBeep(
  [in] UINT uType
);

Parámetros

[in] uType

El sonido que se va a reproducir. El usuario establece los sonidos a través de la aplicación Panel de control de sonido y, a continuación, se almacena en el registro.

Este parámetro puede ser uno de los valores siguientes.

Valor Significado
0xffffffff Un simple pitido. Si la tarjeta de sonido no está disponible, el sonido se genera mediante el altavoz.
MB_ICONASTERISK
0x00000040L
 Consulte MB_ICONINFORMATION.
MB_ICONEXCLAMATION
0x00000030L
 Consulte MB_ICONWARNING.
MB_ICONERROR
0x00000010L
 El sonido especificado como el sonido Detención crítica de Windows.
MB_ICONHAND
0x00000010L
 Consulte MB_ICONERROR.
MB_ICONINFORMATION
0x00000040L
 Sonido especificado como sonido de Windows Asterisco.
MB_ICONQUESTION
0x00000020L
 El sonido especificado como sonido de pregunta de Windows.
MB_ICONSTOP
0x00000010L
 Consulte MB_ICONERROR.
MB_ICONWARNING
0x00000030L
 El sonido especificado como el sonido de Exclamación de Windows.
MB_OK
0x00000000L
 El sonido especificado como sonido de Sonido predeterminado de Windows.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Después de poner en cola el sonido, la función MessageBeep devuelve el control a la función de llamada y reproduce el sonido de forma asincrónica.

Si no puede reproducir el sonido de alerta especificado, MessageBeep intenta reproducir el sonido predeterminado del sistema. Si no puede reproducir el sonido predeterminado del sistema, la función genera un sonido de pitido estándar a través del altavoz del equipo.

El usuario puede deshabilitar el pitido de advertencia mediante la aplicación Panel de control de sonido.

Nota Para enviar un pitido a un cliente remoto, use la función Beep . La función Beep se redirige al cliente, mientras que MessageBeep no.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluya Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-misc-l1-1-0 (introducido en Windows 8)

Consulte también

Beep

Funciones de control de errores

FlashWindow

Notificación al usuario