Bagikan melalui

Fungsi MessageBeep (winuser.h)

  • Artikel

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

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

Sintaks

BOOL MessageBeep(
  [in] UINT uType
);

Parameter

[in] uType

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

Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
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 Tanda Bintang Windows.
MB_ICONQUESTION
0x00000020L
 Suara yang ditentukan sebagai suara Pertanyaan Windows.
MB_ICONSTOP
0x00000010L
 Lihat MB_ICONERROR.
MB_ICONWARNING
0x00000030L
 Suara yang ditentukan sebagai suara Tanda Seru Windows.
MB_OK
0x00000000L
 Suara yang ditentukan sebagai suara 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, hubungi GetLastError.

Keterangan

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 melalui speaker komputer.

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

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header winuser.h (sertakan Windows.h)
Pustaka User32.lib
DLL User32.dll
Set API ext-ms-win-ntuser-misc-l1-1-0 (diperkenalkan dalam Windows 8)

Lihat juga

Bip

Fungsi Penanganan Kesalahan

FlashWindow

Memberi tahu Pengguna