Поделиться через

Функция MessageBeep (winuser.h)

  • Статья

Воспроизводит волновой звук. Звук волны для каждого типа звука определяется записью в реестре.

 
Примечание В Windows Server 2022 задача Microsoft\Windows\Multimedia\SystemSoundsService в планировщике задач отключена. Эта задача должна быть включена для работы MessageBeep.

Синтаксис

BOOL MessageBeep(
  [in] UINT uType
);

Параметры

[in] uType

Воспроизводимый звук. Звуки задаются пользователем с помощью приложения панели управления звуком, а затем сохраняются в реестре.

Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
0xFFFFFFFF Простой звуковой сигнал. Если звуковая карта недоступна, звук создается с помощью динамиков.
MB_ICONASTERISK
0x00000040L
 См . MB_ICONINFORMATION.
MB_ICONEXCLAMATION
0x00000030L
 См . MB_ICONWARNING.
MB_ICONERROR
0x00000010L
 Звук, указанный как звук критической остановки Windows.
MB_ICONHAND
0x00000010L
 См . MB_ICONERROR.
MB_ICONINFORMATION
0x00000040L
 Звук, указанный как звук звездочки Windows.
MB_ICONQUESTION
0x00000020L
 Звук, указанный как звук вопроса Windows.
MB_ICONSTOP
0x00000010L
 См . MB_ICONERROR.
MB_ICONWARNING
0x00000030L
 Звук, указанный как восклицательный звук Windows.
MB_OK
0x00000000L
 Звук, указанный в качестве звукового сигнала windows по умолчанию.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

После постановки звука в очередь функция MessageBeep возвращает управление вызывающей функции и воспроизводит звук асинхронно.

Если не удается воспроизвести указанный звук оповещения, MessageBeep пытается воспроизвести системный звук по умолчанию. Если не удается воспроизвести системный звук по умолчанию, функция создает стандартный звуковой сигнал через динамик компьютера.

Пользователь может отключить звуковой сигнал с помощью приложения панели управления Звук.

Примечание Чтобы отправить звуковой сигнал удаленному клиенту, используйте функцию Beep . Функция Beep перенаправляется на клиент, а MessageBeep — нет.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-misc-l1-1-0 (представлено в Windows 8)

См. также раздел

Beep

Функции обработки ошибок

FlashWindow

Уведомление пользователя