Fungsi bip (utilapiset.h)

Menghasilkan nada sederhana pada speaker. Fungsi ini sinkron; ini melakukan tunggu yang dapat diperingatkan dan tidak mengembalikan kontrol ke pemanggilnya sampai suara selesai.

Sintaks

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

Parameter

[in] dwFreq

Frekuensi suara, dalam hertz. Parameter ini harus dalam rentang 37 hingga 32.767 (0x25 hingga 0x7FFF).

[in] dwDuration

Durasi suara, dalam milidetik.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Dahulu kala, semua komputer PC berbagi chip timer interval umum yang dapat diprogram 8254 untuk generasi suara primitif. Fungsi Bip ditulis khusus untuk memancarkan bip pada perangkat keras itu.

Pada sistem yang lebih lama ini, kontrol bisu dan volume tidak berpengaruh pada Bip; Anda masih akan mendengar nada. Untuk membungkam nada, Anda menggunakan perintah berikut:

bip berhenti bersih

sc config beep start= disabled

Sejak itu, kartu suara telah menjadi peralatan standar di hampir semua komputer PC. Ketika kartu suara menjadi lebih umum, produsen mulai menghapus chip timer lama dari komputer. Chip juga dikecualikan dari desain komputer server. Hasilnya adalah Bahwa Beep tidak bekerja pada semua komputer tanpa chip. Ini tidak apa-apa karena sebagian besar pengembang telah beralih ke memanggil fungsi MessageBeep yang menggunakan apa pun perangkat suara default alih-alih chip 8254.

Akhirnya karena kurangnya perangkat keras untuk berkomunikasi, dukungan untuk Beep dihilangkan di Windows Vista dan Windows XP 64-Bit Edition.

Di Windows 7, Bip ditulis ulang untuk meneruskan bip ke perangkat suara default untuk sesi tersebut. Ini biasanya kartu suara, kecuali ketika dijalankan di bawah Layanan Terminal, dalam hal ini bip dirender pada klien.

Contoh

Contoh berikut menunjukkan penggunaan fungsi ini.

Beep( 750, 300 );

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	utilapiset.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Fungsi Penanganan Kesalahan

MessageBeep

Memberi tahu Pengguna