Bagikan melalui

Fungsi MessageBeep (winuser.h)

  • Artikel

Memainkan suara bentuk gelombang. Suara bentuk gelombang untuk setiap jenis suara diidentifikasi oleh entri dalam registri.

 
Catatan Di Windows Server 2022, tugas Microsoft\Windows\Multimedia\SystemSoundsService di Task Scheduler dinonaktifkan. Tugas ini perlu diaktifkan agar MessageBeep berfungsi.

Sintaksis

BOOL MessageBeep(
  [in] UINT uType
);

Parameter

[in] uType

Suara yang akan dimainkan. Suara diatur oleh pengguna melalui aplikasi panel kontrol Suara, dan kemudian disimpan di registri.

Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Arti
0xFFFFFFFF Bip sederhana. Jika kartu suara tidak tersedia, suara dihasilkan menggunakan speaker.
MB_ICONASTERISK
0x00000040L
 Lihat MB_ICONINFORMATION.
MB_ICONEXCLAMATION
0x00000030L
 Lihat MB_ICONWARNING.
MB_ICONERROR
0x00000010L
 Suara yang ditentukan sebagai suara Windows Critical Stop.
MB_ICONHAND
0x00000010L
 Lihat MB_ICONERROR.
MB_ICONINFORMATION
0x00000040L
 Suara yang ditentukan sebagai suara Windows Asterisk.
MB_ICONQUESTION
0x00000020L
 Suara yang ditentukan sebagai suara Pertanyaan Windows.
MB_ICONSTOP
0x00000010L
 Lihat MB_ICONERROR.
MB_ICONWARNING
0x00000030L
 Suara yang ditentukan sebagai suara Seru Windows.
MB_OK
0x00000000L
 Suara yang ditentukan sebagai suara Bunyi Bip Default Windows.

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

Setelah mengantrekan suara, fungsi MessageBeep mengembalikan kontrol ke fungsi panggilan dan memutar suara secara asinkron.

Jika tidak dapat memutar suara pemberitahuan yang ditentukan, MessageBeep mencoba memutar suara default sistem. Jika tidak dapat memutar suara default sistem, fungsi menghasilkan suara bip standar menggunakan fungsi Beep. Mulai dari Windows 7, ini memainkan nada sederhana pada perangkat suara default. Lihat dokumentasi untuk fungsi Beep untuk detail lebih lanjut.

Pengguna dapat menonaktifkan bip peringatan dengan menggunakan aplikasi panel kontrol Suara.

Catatan Untuk mengirim bip ke klien jarak jauh, gunakan fungsi Beep. Fungsi Beep dialihkan ke klien, sedangkan MessageBeep tidak.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows XP [hanya aplikasi desktop]
server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Platform Target Windows
Header winuser.h (termasuk Windows.h)
Pustaka User32.lib
DLL User32.dll
set API ext-ms-win-ntuser-misc-l1-1-0 (diperkenalkan di Windows 8)

Lihat juga

Beep

Fungsi Penanganan Kesalahan

FlashWindow

Memberi tahu Pengguna