MessageBeep 函数 (winuser.h)
播放波形声音。 每个声音类型的波形声音由注册表中的一个条目标识。
Windows Server 2022 上的注释,任务计划程序中的 Microsoft\Windows\Multimedia\SystemSoundsService 任务处于禁用状态。 需要启用此任务才能使 MessageBeep 正常工作。
语法
BOOL MessageBeep(
[in] UINT uType
);
参数
[in] uType
要播放的声音。 声音由用户通过声音控制面板应用程序设置,然后存储在注册表中。
此参数可以是下列值之一。
价值 | 意义 |
---|---|
0xFFFFFFFF | 一个简单的蜂鸣声。 如果声卡不可用,则使用扬声器生成声音。 |
|
请参阅 MB_ICONINFORMATION。 |
|
请参阅 MB_ICONWARNING。 |
|
指定为 Windows 关键停止声音的声音。 |
|
请参阅 MB_ICONERROR。 |
|
指定为 Windows 星号声音的声音。 |
|
指定为 Windows 问题声音的声音。 |
|
请参阅 MB_ICONERROR。 |
|
指定为 Windows 感叹号声音的声音。 |
|
指定为 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 中引入) |