MessageBeep 関数 (winuser.h)
波形サウンドを再生します。 各サウンドの種類の波形サウンドは、レジストリ内のエントリによって識別されます。
Windows Server 2022 の、タスク スケジューラの Microsoft\Windows\Multimedia\SystemSoundsService タスクは無効になっています。 MessageBeep が機能するには、このタスクを有効にする必要があります。
構文
BOOL MessageBeep(
[in] UINT uType
);
パラメーター
[in] uType
再生するサウンド。 サウンドは、サウンド コントロール パネル アプリケーションを介してユーザーによって設定され、レジストリに格納されます。
このパラメーターには、次のいずれかの値を指定できます。
| 価値 | 意味 |
|---|---|
| 0xFFFFFFFF | 単純なビープ音。 サウンド カードが使用できない場合は、スピーカーを使用してサウンドが生成されます。 |
|
MB_ICONINFORMATIONを参照してください。 |
|
MB_ICONWARNINGを参照してください。 |
|
Windows Critical Stop サウンドとして指定されたサウンド。 |
|
MB_ICONERRORを参照してください。 |
|
Windows アスタリスク サウンドとして指定されたサウンド。 |
|
Windows 質問のサウンドとして指定されたサウンド。 |
|
MB_ICONERRORを参照してください。 |
|
Windows 感嘆符として指定されたサウンド。 |
|
Windows の既定のビープ音として指定されたサウンド。 |
戻り値
関数が成功した場合、戻り値は 0 以外です。
関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError 呼び出します。
備考
サウンドをキューに入れると、MessageBeep 関数は呼び出し元の関数に制御を返し、非同期的にサウンドを再生します。
指定した警告音を再生できない場合は、MessageBeep システムの既定のサウンドの再生を試みます。 システムの既定のサウンドを再生できない場合は、Beep 関数を使用して標準のビープ音が生成されます。 Windows 7 以降では、既定のサウンド デバイスで単純なトーンが再生されます。 詳細については、Beep 関数のドキュメントを参照してください。
ユーザーは、サウンドコントロールパネルアプリケーションを使用して警告ビープ音を無効にすることができます。
メモ リモート クライアントにビープ音を送信するには、Beep 関数を使用します。 Beep 関数はクライアントにリダイレクトされますが、MessageBeep リダイレクトされません。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | winuser.h (Windows.h を含む) |
| ライブラリ | User32.lib |
| DLL | User32.dll |
| API セットの | ext-ms-win-ntuser-misc-l1-1-0 (Windows 8 で導入) |
関連項目
ユーザー への通知の