小甲鱼 发表于 2016-4-20 00:08:40

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)所有,转载请注明来源。

页: [1]
查看完整版本: Beep