Функция beep (utilapiset.h)

Статья
08/26/2023

Создает простые тона для говорящего. Функция является синхронной; он выполняет ожидание с оповещениями и не возвращает управление вызывающему объекту до тех пор, пока звук не закончится.

Синтаксис

BOOL Beep(
  [in] DWORD dwFreq,
  [in] DWORD dwDuration
);

Параметры

[in] dwFreq

Частота звука, в герцах. Этот параметр должен находиться в диапазоне от 37 до 32 767 (0x25 0x7FFF).

[in] dwDuration

Длительность звука в миллисекундах.

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

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

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

Давным-давно все компьютеры пк совместно используют общую программируемую микросхему интервала таймера 8254 для создания примитивных звуков. Функция Beep была написана специально для того, чтобы издать звуковой сигнал на этом оборудовании.

В этих старых системах регуляторы звука и громкости не влияют на звуковой сигнал; вы все равно услышите тон. Чтобы заглушить звук, вы использовали следующие команды:

чистый сигнал остановки

sc config beep start= disabled

С тех пор звуковые карты стали стандартным оборудованием почти на всех компьютерах. По мере того как звуковые карты стали более распространенными, производители начали удалять старый чип таймера с компьютеров. Микросхемы также были исключены из конструкции серверных компьютеров. В результате beep не работал на всех компьютерах без микросхемы. Это было нормально, потому что большинство разработчиков перешли к вызову функции MessageBeep , которая использует любое звуковое устройство по умолчанию вместо микросхемы 8254.

В конечном итоге из-за отсутствия оборудования для связи поддержка звукового сигнала была прекращена в Windows Vista и Windows XP 64-разрядной версии.

В Windows 7 звуковой сигнал был перезаписан для передачи звукового устройства по умолчанию для сеанса. Обычно это звуковой карта, за исключением случаев запуска в службах терминалов, и в этом случае звуковой сигнал отображается на клиенте.

Примеры

В следующем примере показано использование этой функции.

Beep( 750, 300 );

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	utilapiset.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

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

MessageBeep

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

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