【MQL5】PlaySound関数について

bool  PlaySound(
  string  filename      // ファイル名
  );

#include <Trade\Trade.mqh>   // 取引関連の機能を使用するためのヘッダーファイルをインクルード
#define MAGIC (123)          // マジックナンバーを定義（この数値はEAの識別に使われます）
 
//--- 入力パラメータ
input string         InpFileNameOK  = "ok.wav";             // 注文成功時に再生する音声ファイルの名前
input string         InpFileNameErr = "timeout.wav";        // 注文失敗時に再生する音声ファイルの名前
input ENUM_ORDER_TYPE InpOrderType   = ORDER_TYPE_BUY_LIMIT; // 注文の種類（ここでは買いの指値注文）
input double         InpLots        = 0.1;                 // 注文するロット数
 
//--- グローバル変数
CTrade ExtTrade;  // CTradeクラスのインスタンスを作成、これにより取引関連のメソッドを利用可能
 
//+------------------------------------------------------------------+
//| スクリプトの開始関数                                               |
//+------------------------------------------------------------------+
void OnStart()
 {
  //--- マジックナンバーと取引タイプの設定
  ExtTrade.SetExpertMagicNumber(MAGIC);    // 設定したマジックナンバーをEAに適用
  ExtTrade.SetTypeFillingBySymbol(Symbol()); // 銘柄に応じた注文埋め方式を設定

  //--- 注文を出し、サウンドを再生する関数を呼び出し
  OrderSendWithAudio();
 }
 
//+------------------------------------------------------------------+
//| 注文を発注し、結果に応じて音声を再生する関数                      |
//+------------------------------------------------------------------+
void OrderSendWithAudio(void)
 {
  bool res = true;         // 成否を確認するための変数
  MqlTick tick = {};       // MqlTick構造体を初期化（現在の価格情報を格納）

  ResetLastError();        // エラーコードをリセット
  if(!SymbolInfoTick(Symbol(), tick))  // 現在の価格情報を取得、失敗した場合
    {
    Print("SymbolInfoTick() failed. Error code: ", GetLastError());  // エラー内容をエキスパートログに表示
    PlaySound(InpFileNameErr);   // エラー時のサウンドを再生
    return;
    }
    
  //--- 入力パラメータに従って注文を発注
  switch(InpOrderType)
    {
    case ORDER_TYPE_BUY :    // 成行買い注文の場合
        res = ExtTrade.Buy(InpLots);   // 成行買い注文を実行
        break;
    case ORDER_TYPE_BUY_LIMIT :    // 指値買い注文の場合
        res = ExtTrade.BuyLimit(InpLots, NormalizeDouble(tick.ask - 100 * Point(), Digits()));   // 現在の価格から100ポイント下に指値を設定して発注
        break;
    case ORDER_TYPE_BUY_STOP :     // 逆指値買い注文の場合
        res = ExtTrade.BuyStop(InpLots, NormalizeDouble(tick.ask + 100 * Point(), Digits()));   // 現在の価格から100ポイント上に逆指値を設定して発注
        break;
    case ORDER_TYPE_SELL :     // 成行売り注文の場合
        res = ExtTrade.Sell(InpLots);    // 成行売り注文を実行
        break;
    case ORDER_TYPE_SELL_LIMIT :    // 指値売り注文の場合
        res = ExtTrade.SellLimit(InpLots, NormalizeDouble(tick.bid + 100 * Point(), Digits()));  // 現在の価格から100ポイント上に指値を設定して発注
        break;
    case ORDER_TYPE_SELL_STOP :     // 逆指値売り注文の場合
        res = ExtTrade.SellStop(InpLots, NormalizeDouble(tick.bid - 100 * Point(), Digits()));   // 現在の価格から100ポイント下に逆指値を設定して発注
        break;
    default :
        res = false;    // それ以外の注文タイプは無効
    }

  //--- 注文の発注結果に応じてログを出力
  if(!res)   // 注文に失敗した場合
    Print("Error ", GetLastError());  // エラーメッセージをエキスパートログに出力
  Print(ExtTrade.ResultRetcodeDescription());  // サーバーからの応答コードの説明を出力

  //--- 注文が成功したかどうかでサウンドを再生
  if(ExtTrade.ResultRetcode() == TRADE_RETCODE_DONE)   // 成功時の応答コードを確認
    PlaySound(InpFileNameOK);    // 成功音を再生
  else
    PlaySound(InpFileNameErr);   // 失敗時の音を再生
 }
```

### 解説:

- **`ExtTrade.SetExpertMagicNumber(MAGIC)`**  
  マジックナンバーを設定します。マジックナンバーはエキスパートアドバイザー（EA）が発注した注文を識別するために使われます。

- **`SymbolInfoTick(Symbol(), tick)`**  
  現在の価格（ティック）情報を取得します。取得に失敗した場合は、エラーメッセージを表示してエラー音を再生します。

- **`NormalizeDouble()`**  
  値を指定した小数点桁数に丸める関数です。価格を適切に丸めるために使われています。

- **`PlaySound()`**  
  成功または失敗に応じてサウンドを再生します。

#include <Trade\Trade.mqh>   // 取引関連の機能を使用するためのヘッダーファイルをインクルード
#define MAGIC (123)          // マジックナンバーを定義（この数値はEAの識別に使われます）
 
//--- 入力パラメータ
input string         InpFileNameOK  = "ok.wav";             // 注文成功時に再生する音声ファイルの名前
input string         InpFileNameErr = "timeout.wav";        // 注文失敗時に再生する音声ファイルの名前
input ENUM_ORDER_TYPE InpOrderType   = ORDER_TYPE_BUY_LIMIT; // 注文の種類（ここでは買いの指値注文）
input double         InpLots        = 0.1;                 // 注文するロット数
 
//--- グローバル変数
CTrade ExtTrade;  // CTradeクラスのインスタンスを作成、これにより取引関連のメソッドを利用可能

//+------------------------------------------------------------------+
//| スクリプトの開始関数                                               |
//+------------------------------------------------------------------+
void OnStart()
 {
  //--- マジックナンバーと取引タイプの設定
  ExtTrade.SetExpertMagicNumber(MAGIC);    // 設定したマジックナンバーをEAに適用
  ExtTrade.SetTypeFillingBySymbol(Symbol()); // 銘柄に応じた注文埋め方式を設定

  //--- 注文を出し、サウンドを再生する関数を呼び出し
  OrderSendWithAudio();
 }
 

//+------------------------------------------------------------------+
//| 注文を発注し、結果に応じて音声を再生する関数                      |
//+------------------------------------------------------------------+
void OrderSendWithAudio(void)
 {
  bool res = true;         // 成否を確認するための変数
  MqlTick tick = {};       // MqlTick構造体を初期化（現在の価格情報を格納）

  ResetLastError();        // エラーコードをリセット
  if(!SymbolInfoTick(Symbol(), tick))  // 現在の価格情報を取得、失敗した場合
    {
    Print("SymbolInfoTick() failed. Error code: ", GetLastError());  // エラー内容をエキスパートログに表示
    PlaySound(InpFileNameErr);   // エラー時のサウンドを再生
    return;
    }

  //--- 入力パラメータに従って注文を発注
  switch(InpOrderType)
    {
    case ORDER_TYPE_BUY :    // 成行買い注文の場合
        res = ExtTrade.Buy(InpLots);   // 成行買い注文を実行
        break;
    case ORDER_TYPE_BUY_LIMIT :    // 指値買い注文の場合
        res = ExtTrade.BuyLimit(InpLots, NormalizeDouble(tick.ask - 100 * Point(), Digits()));   // 現在の価格から100ポイント下に指値を設定して発注
        break;
    case ORDER_TYPE_BUY_STOP :     // 逆指値買い注文の場合
        res = ExtTrade.BuyStop(InpLots, NormalizeDouble(tick.ask + 100 * Point(), Digits()));   // 現在の価格から100ポイント上に逆指値を設定して発注
        break;
    case ORDER_TYPE_SELL :     // 成行売り注文の場合
        res = ExtTrade.Sell(InpLots);    // 成行売り注文を実行
        break;
    case ORDER_TYPE_SELL_LIMIT :    // 指値売り注文の場合
        res = ExtTrade.SellLimit(InpLots, NormalizeDouble(tick.bid + 100 * Point(), Digits()));  // 現在の価格から100ポイント上に指値を設定して発注
        break;
    case ORDER_TYPE_SELL_STOP :     // 逆指値売り注文の場合
        res = ExtTrade.SellStop(InpLots, NormalizeDouble(tick.bid - 100 * Point(), Digits()));   // 現在の価格から100ポイント下に逆指値を設定して発注
        break;
    default :
        res = false;    // それ以外の注文タイプは無効
    }

 //--- 注文の発注結果に応じてログを出力
  if(!res)   // 注文に失敗した場合
    Print("Error ", GetLastError());  // エラーメッセージをエキスパートログに出力
  Print(ExtTrade.ResultRetcodeDescription());  // サーバーからの応答コードの説明を出力

  //--- 注文が成功したかどうかでサウンドを再生
  if(ExtTrade.ResultRetcode() == TRADE_RETCODE_DONE)   // 成功時の応答コードを確認
    PlaySound(InpFileNameOK);    // 成功音を再生
  else
    PlaySound(InpFileNameErr);   // 失敗時の音を再生
 }