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

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

  • Статья

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

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

Синтаксис

BOOL MessageBeep(
  [in] UINT uType
);

Параметры

[in] uType

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

Этот параметр может быть одним из следующих значений.

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

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

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

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

Замечания

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

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

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

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

Требования

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

См. также

Beep

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

FlashWindow

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