Beep 函式 (utilapiset.h)

  • 發行項

在喇叭上產生簡單的音調。 函式是同步的;它會執行可警示的等候，而且在音效完成之前，不會將控制權傳回給其呼叫端。

語法

BOOL Beep(
  [in] DWORD dwFreq,
  [in] DWORD dwDuration
);

參數

[in] dwFreq

音效的頻率，以長長為單位。 此參數的範圍必須介於 37 到 32,767 (0x25 到0x7FFF) 之间。

[in] dwDuration

音效的持續時間，以毫秒為單位。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

很長一段時間前，所有計算機計算機都會共用通用的8254可程式化間隔定時器晶片，以產生基本音效。 Beep 函式是特別撰寫，可在該硬體片段上發出嗶聲。

在這些較舊的系統上，靜音和音量控件不會影響 Beep;您仍然會聽到語調。 若要讓音調無聲，您已使用下列命令：

net stop beep

sc config beep start= disabled

之後，聲卡幾乎在所有計算機計算機上都成為標準設備。 當聲卡變得更常見時，製造商開始從計算機中移除舊的定時器晶元。 晶片也會從伺服器計算機的設計中排除。 結果是 ，Beep 無法在沒有晶元的所有計算機上運作。 這沒問題，因為大部分開發人員都已移至呼叫使用預設音效裝置而非8254晶片的 MessageBeep 函式。

最後，由於缺少與硬體通訊，因此 Windows Vista 和 Windows XP 64 位版本已卸除 Beep 的支援。

在 Windows 7 中， 已重寫 Beep ，以將嗶聲傳遞給會話的預設音效裝置。 這通常是聲音卡，除非在終端機服務下執行，在此情況下，會在用戶端上轉譯嗶聲。

範例

以下範例示範此函數的用法。

Beep( 750, 300 );

規格需求

需求 值
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 utilapiset.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

錯誤處理函式

MessageBeep

通知使用者