Beep

小甲鱼

注：本文档由 ouyunfu 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

Beep 函数用于在扬声器上生成简单的音调。因为该函数同步的，所以如果执行一个报警性等待操作，需要直到声音结束，调用者才可以重获控制权。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL WINAPI Beep(
  _In_ DWORD dwFreq,
  _In_ DWORD dwDuration
);

参数解析：

参数	含义
dwFreq	指定声音的频率，可选范围：37 ~ 32767 赫兹（0x25 ~ 0x7FFF）
dwDuration	指定声音持续时间，以毫秒为单位

返回值：

1. 如果函数调用成功，返回值为非 0；

2. 如果函数调用失败，返回值为 0。

获取有关错误的更多信息，请调用 GetLastError 函数。


备注：

很久以前，所有的个人电脑享有一个共同的 8254 可编程间隔定时器芯片以生成原始的声音。Beep 函数的编写初衷就是使这硬件发出蜂鸣声。

在这些老版系统里，静音和音量控制对发出蜂鸣声无影响，你将会一直听到这个音调。如果你想关闭它，得利用以下命令：

net stop beep
sc config beep start= disabled

自那以后，声卡已经成为标准装备应用于几乎所有个人电脑。由于声卡逐渐普及，厂商开始删除计算机上的旧定时器芯片。甚至服务器的设计也不考虑应用该芯片。其结果是，若没有芯片，所有计算机的蜂鸣发声将不能实现。但这没关系，因为大多数开发人员都转移到调用 MessageBeep 函数使用任何默认的声音设备，而不是 8254 芯片。

最终，由于缺乏硬件进行通信， Windows Vista 和 Windows XP（64位）也最终放弃对于 Beep 函数的支持。

在 Windows 7 中，Beep 函数被改写成可传递到默认声音设备上。这通常是声卡，但有种情况除外，即在终端服务下，蜂鸣声呈现给客户时。


需求：

Minimum supported client	Windows XP [仅桌面应用程序]
Minimum supported server	Windows 2003 服务器版 [仅桌面应用程序]
Header	WinBase.h (包含于 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。