Fungsi bip (utilapiset.h)

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

Sintaksis

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.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Komentar

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

Pada sistem yang lebih lama ini, kontrol bisukan dan volume tidak berpengaruh pada Beep; 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 Beep tidak berfungsi pada semua komputer tanpa chip. Ini baik-baik saja karena sebagian besar pengembang telah beralih untuk memanggil fungsi MessageBeep yang menggunakan apa pun yang merupakan perangkat suara default alih-alih chip 8254.

Akhirnya karena kurangnya perangkat keras untuk berkomunikasi, dukungan untuk memutar suara dari speaker motherboard dihilangkan di Windows Vista dan Windows XP 64-Bit Edition.

Di Windows 7, Beep 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

Lihat juga

Fungsi Penanganan Kesalahan

MessageBeep

Memberi tahu Pengguna