MessageBeep

[funkcja] Odtwarza dźwięki sygnalizujące komunikaty Windows, specyfikowane przez wpisy w rejestrze.

Składnia

#include <windows.h>

BOOL WINAPI MessageBeep(
UINT uType
);

Argumenty

Argument	Znaczenie
uType	Dźwięk, który zostanie odegrany. Jest on określony przez użycie jednej z nastepujących flag: 0xFFFFFFFF (0xFFFFFFFF) Prosty sygnał dźwiękowy. Jeżeli karta dźwiękowa jest niedostępna, dźwięk jest generowany za pomocą głośnika. MB_ICONASTERISK (0x00000040L) Zobacz MB_ICONINFORMATION. MB_ICONEXCLAMATION (0x00000030L) Zobacz MB_ICONWARNING. MB_ICONERROR (0x00000010L) Dźwięk określony w rejestrze jako dźwięk błędu krytycznego. MB_ICONHAND (0x00000010L) Zobacz MB_ICONERROR. MB_ICONINFORMATION (0x00000040L) Dźwięk określony w rejestrze jako dźwięk informacji. MB_ICONQUESTION (0x00000020L) Dźwięk określony w rejestrze jako dźwięk zapytania. MB_ICONSTOP (0x00000010L Zobacz MB_ICONERROR. MB_ICONWARNING (0x00000030L) Dźwięk określony w rejestrze jako dźwięk ostrzeżenia. MB_OK (0x00000000L) Dźwięk określony w rejestrze jako domyślny dźwięk sytemu Windows.

Argument

Znaczenie

uType

Dźwięk, który zostanie odegrany. Jest on określony przez użycie jednej z nastepujących flag:

0xFFFFFFFF (0xFFFFFFFF)
Prosty sygnał dźwiękowy. Jeżeli karta dźwiękowa jest niedostępna, dźwięk jest generowany za pomocą głośnika.
MB_ICONASTERISK (0x00000040L)
Zobacz MB_ICONINFORMATION.
MB_ICONEXCLAMATION (0x00000030L)
Zobacz MB_ICONWARNING.
MB_ICONERROR (0x00000010L)
Dźwięk określony w rejestrze jako dźwięk błędu krytycznego.
MB_ICONHAND (0x00000010L)
Zobacz MB_ICONERROR.
MB_ICONINFORMATION (0x00000040L)
Dźwięk określony w rejestrze jako dźwięk informacji.
MB_ICONQUESTION (0x00000020L)
Dźwięk określony w rejestrze jako dźwięk zapytania.
MB_ICONSTOP (0x00000010L
Zobacz MB_ICONERROR.
MB_ICONWARNING (0x00000030L)
Dźwięk określony w rejestrze jako dźwięk ostrzeżenia.
MB_OK (0x00000000L)
Dźwięk określony w rejestrze jako domyślny dźwięk sytemu Windows.

Zwracana wartość

Jeśli wywołanie funkcji powiedzie się, zwrócona wartość będzie różna od zera. W przeciwnym wypadku wyniesie ona 0. Aby uzyskać szczegółowe informacje o błędzie, użyj _{» WinAPI ♦}GetLastError.

Opis szczegółowy

Funkcja MessageBeep odgrywa podany dźwięk specyfikowany przez wpis w rejestrze. Po wywołaniu funkcja zwraca sterowanie do funkcji wywołującej i odtwarza dźwięk asynchronicznie.

Jeśli nie można odtworzyć podanego dźwięku, funkcja próbuje odegrać domyślny dźwięk systemu. Jeśli tego także nie uda się odtworzyć, funkcja tworzy standardowy dźwięk przez głośnik komputera.

Użytkownik może wyłączyć odgrywanie dźwięków przy użyciu panelu sterowania.

Usługi terminalowe:
Aby wysłać sygnał do klienta, należy użyć funkcji _{» WinAPI ♦}Beep, ponieważ jest ona przekierowywana do klienta, podczas gdy funkcja MessageBeep nie jest.

Wymagania

Minimalny obsługiwany klient	Windows XP
Minimalny obsługiwany serwer	Windows Server 2003
Nagłówek	Winuser.h (wewnątrz Windows.h)
Biblioteka	User32.lib
DLL	User32.dll

Zagadnienia powiązane

Beep	Generuje dźwięki tonowe na wbudowanym głośniku (funkcja blokująca). (funkcja)

Linki zewnętrzne

http://msdn.microsoft.com/en-us/library/windows/desktop/ms680356(v=vs.85).aspx

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.