Beep()函数介绍

简介

Beep()函数是Windows API中的一个函数，用于发出短或长的蜂鸣声。该函数接收两个参数，第一个参数为声音频率，第二个参数为声音持续时间，单位为毫秒。该函数只能在Windows平台上使用，不能在其他操作系统上使用。

语法

#include <windows.h>
BOOL Beep(
  DWORD dwFreq,  // 声音的频率
  DWORD dwDur    // 声音持续的时间，单位为毫秒
);

参数

• dwFreq：无符号整数，指定播放声音的频率，单位为赫兹。范围从37至32767赫兹。一般来说，较高的频率会产生更高的音调。
• dwDur：无符号整数，指定播放声音的持续时间，单位为毫秒。1秒等于1000毫秒。如果该值为0，声音将持续到调用Beep()函数的线程被挂起或终止。

返回值

• 如果函数执行成功，则返回值为TRUE。
• 如果函数执行失败，则返回值为FALSE。

示例

以下示例代码可以让计算机发出一个频率为500赫兹，持续时间为1000毫秒(即1秒钟)的声音：

#include <windows.h>
int main() {
  Beep(500, 1000);
  return 0;
}

值得注意的是，Beep()函数会仅保证声音的频率和持续时间，但不保证声音的音量。如果需要调节声音的音量，可以考虑使用其他的库或API。