MessageBeep 函式 (winuser.h)
播放超聲波音效。 登錄中的項目會識別每個音效類型的超聲波音效。
Windows Server 2022 上的附註,工作排程器中的 Microsoft\Windows\Multimedia\SystemSoundsService 工作已停用。 必須啟用此工作,MessageBeep 才能運作。
語法
BOOL MessageBeep(
[in] UINT uType
);
參數
[in] uType
要播放的聲音。 音效是由使用者透過 Sound 控制面板應用程式所設定,然後儲存在登錄中。
此參數可以是下列其中一個值。
價值 | 意義 |
---|---|
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 中引進) |